Connect AI agents to the Clay MCP server

Vendor MCP

The Clay MCP connector routes your AI agent's tool calls to Clay's own MCP server through Scalekit. Each user signs in to Clay once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 21 tools.

Tools: 21
What they doRead · write · destructive: 13 · 5 · 313 read5 write3 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
Set your credentials
Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.
.env
```
SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
SCALEKIT_CLIENT_ID=<your-client-id>
SCALEKIT_CLIENT_SECRET=<your-client-secret>
```
Create the Clay MCP connection
In AgentKit > Connections, create a Clay MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Clay MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'claymcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Clay MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'claymcp_get_credits_available',
27
  toolInput: { rationale: 'YOUR_RATIONALE' },
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "claymcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Clay MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={"rationale":"YOUR_RATIONALE"},
27
    tool_name="claymcp_get_credits_available",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

claymcp_add_company_data_pointsAdd data points to companies in an existing search.Read-only
Add Company Data Points
Add data points to companies in an existing search. Supports enriching ALL companies or specific companies via entityIds. Use for tech stack, funding, headcount, competitors, or any custom research question about companies.
Inputs
dataPointsarrayrequired
The data points to apply to the company
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
taskIdstringrequired
The task ID identifying the search to add company data points to
entityIdsarray
Optional. Array of entityIds to enrich. When omitted, enriches all companies.
claymcp_add_contact_data_pointsAdd data points to contacts in an existing search.Read-only
Add Contact Data Points
Add data points to contacts in an existing search. Supports enriching ALL contacts or specific contacts via entityIds. Use for emails, phone numbers, work history, thought leadership, or any custom research question about contacts.
Inputs
dataPointsarrayrequired
The data points to apply to the contacts
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
taskIdstringrequired
The task ID identifying the search to add contact data points to
entityIdsarray
Optional. Array of entityIds to enrich. When omitted, enriches all contacts.
claymcp_ask_question_about_accountsAsk a natural language question about one or more accounts available in Clay Audiences.Read-only
Ask Question About Accounts
Ask a natural language question about one or more accounts available in Clay Audiences. An AI agent analyzes account data including contacts, opportunities, Gong calls, and emails to answer the question.
Inputs
accountIdsarrayrequired
Account IDs to analyze (1-10)
questionstringrequired
Natural language question about the accounts
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
claymcp_get_credits_availableCheck if credits are available for the workspace.Read-only
Get Credits Available
Check if credits are available for the workspace. Returns hasWorkspaceCredits, hasSalesRepCredits, and (when credit budgets are enabled) hasBudgetCredits.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
claymcp_get_current_workspaceReport which Clay workspace this connection is pinned to.Read-only
Get Current Workspace
Report which Clay workspace this connection is pinned to. Returns workspaceName, workspaceId, and workspaceUrl. Use when the user asks which workspace they are connected to, or to confirm where searches and enrichments will run.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
claymcp_get_subroutine_input_optionsFetch the available dropdown options for a subroutine input that has a configured options source.Read-only
Get Subroutine Input Options
Fetch the available dropdown options for a subroutine input that has a configured options source.
Inputs
inputNamestringrequired
The name of the input whose options to fetch.
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
subroutine_idstringrequired
The ID of the subroutine.
claymcp_get_taskGet task status and results by task ID.Read-only
Get Task
Get task status and results by task ID. Handles all task types (search, direct) and returns the current state. Accepts universal mcp-task-* IDs and legacy cgas-search-id-* IDs.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
taskIdstringrequired
The task ID to retrieve (mcp-task-* or legacy cgas-search-id-*)
pageinteger
Optional 1-based page of entities for direct tasks (100 per page). Defaults to 1.
claymcp_get_task_contextRetrieve the current state of a task — all entities, enrichment values, and statuses.Read-only
Get Task Context
Retrieve the current state of a task — all entities, enrichment values, and statuses. Call this to get actual enrichment results (emails, phone numbers, work history, custom data points) after a search or enrichment operation.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
taskIdstringrequired
The task ID to retrieve (mcp-task-* or legacy cgas-search-id-*)
entityIdsarray
Optional. Pass specific entity IDs to retrieve only those entities. Leave empty or omit to retrieve all entities for the task.
pageinteger
Optional 1-based page of entities for direct tasks (100 per page). Defaults to 1. Ignored when entityIds is provided.
claymcp_list_subroutinesList available custom functions in the workspace.Read-only
List Subroutines
List available custom functions in the workspace. Call this to see their required inputs before using run_subroutine.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
claymcp_query_objectsQuery audience accounts, contacts, or deals using natural language.Read-only
Query Objects
Query audience accounts, contacts, or deals using natural language. Translates plain language descriptions into structured filters and returns matching entities with field values from Clay Audiences.
Inputs
querystringrequired
Natural language description of what to filter, e.g. "tech companies with 500+ employees"
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
audienceNamestring
Name of a saved audience segment to scope results to
limitinteger
Max rows to returndefault 50
offsetinteger
Pagination offsetdefault 0
onlyMineboolean
When true, restrict account results to the caller's Salesforce-owned accounts
claymcp_search_companiesFind a LIST of companies matching prospecting filters (industry, size, location, funding, tech stack, keywords), expressed as a Search DSL query.Read-only
Search Companies
Find a LIST of companies matching prospecting filters (industry, size, location, funding, tech stack, keywords), expressed as a Search DSL query. This searches PUBLICLY AVAILABLE company data — it is NOT for the user's own account/CRM data. ## Quick Reference - **This tool**: Find companies by CRITERIA (e.g. "fintech companies in NYC with 50-200 employees", "Series B SaaS companies using Salesforce"). - **search-contacts**: Find TYPES of people at a company (e.g. "engineers at Stripe"). - **search-contacts-by-name**: Find SPECIFIC named people (e.g. "John Smith at Stripe"). - **query-objects** + **ask-question-about-accounts**: Ask about the user's OWN accounts/deals/CRM. ## Parameters ### dslQuery (required) A Search DSL query that MUST start with `select from companies`. Translate the user's natural-language prospecting request into filters. Only filter on what the user explicitly asks for. ## Search DSL Write a single Search DSL query. Grammar: ``` query = "select" "from" entity where? limit_by? limit? entity = "people" | "companies" where = "where" predicate limit_by = "limit" POSITIVE_INT "by" "clay_company_id" (people only) limit = "limit" INTEGER predicate = or_expr or_expr = and_expr ("or" and_expr)* and_expr = unary ("and" unary)* unary = "not" unary | comparison | aggregate | "(" predicate ")" comparison = field op value | field "is_null" | field "is_not_null" op = "=" | "!=" | "<" | "<=" | ">" | ">=" | "contains" | "starts_with" | "ends_with" | "in" | "not_in" | "is_similar_to" value = STRING | NUMBER | BOOLEAN | "(" value ("," value)* ")" | date_expr date_expr = "today" "(" ")" (("+" | "-") "interval" POSITIVE_INT unit)? unit = "day[s]" | "week[s]" | "month[s]" | "year[s]" ``` ### Operators - `contains` is whole-token match (not substring); list form: `field contains ("a", "b")`. - `in` / `not_in` take a value list; enum fields support only `=`, `!=`, `in`, `not_in`. - `is_similar_to` expands meaning (e.g. `job_title is_similar_to ("VP Sales")`). - `and` binds tighter than `or`; group with parentheses. ### Limits - Add `limit N` only when the user asks for a specific total count. - `limit N by clay_company_id` (people queries only) caps results per company. ### Company fields - domain (string): Company website domain, e.g. 'google.com', 'stripe.com'. - description (string): Company description. Use contains for keyword matching. - products_and_services (string): What the company does, makes, and sells, matched semantically against company document embeddings. Only supports is_similar_to with one or more non-empty string values; multiple values match companies similar to ANY value (e.g. products_and_services is_similar_to ("b2b saas", "crm")). Distinct from description keyword matching; not all companies have embeddings, and rows without one never match. - company_type (string, enum): Company type classification. Values: "Privately Held" (Privately held), "Public Company" (Public company), "Partnership", "Self Employed" (Self-employed), "Non Profit" (Nonprofit), "Educational", "Self Owned" (Self-owned), "Government Agency" (Government agency) - company_size (string, enum): Company size range bucket. Prefer this for first-pass company-size filtering; use estimated_employee_count only when the user explicitly asks for exact employee count/headcount. Values: "1" (1 employee), "2-10" (2–10 employees), "11-50" (11–50 employees), "51-200" (51–200 employees), "201-500" (201–500 employees), "501-1,000" (501–1,000 employees), "1,001-5,000" (1,001–5,000 employees), "5,001-10,000" (5,001–10,000 employees), "10,001+" (10,001+ employees) - estimated_employee_count (number): Estimated total employee count. Use only when the user explicitly asks for exact employee count/headcount or asks to switch from company-size buckets to exact counts. - estimated_follower_count (number): Estimated social media audience/follower count. - year_founded (year): Year the company was founded. - employee_growth_3mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_6mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_12mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_24mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - annual_revenue (string, enum): Annual revenue bracket. Use = or in with exact bucket values, not numeric operators. Values: "0-500K" ($0–$500K), "500K-1M" ($500K–$1M), "1M-5M" ($1M–$5M), "5M-10M" ($5M–$10M), "10M-25M" ($10M–$25M), "25M-75M" ($25M–$75M), "75M-200M" ($75M–$200M), "200M-500M" ($200M–$500M), "500M-1B" ($500M–$1B), "1B-10B" ($1B–$10B), "10B-100B" ($10B–$100B), "100B-1T" ($100B+) - ai_business_types (string): Derived business model type. LOW COVERAGE — treat as optional: always pair with an is_null fallback, e.g. (ai_business_types contains "B2B" or ai_business_types is_null). Use contains for matching. Common: "B2B", "B2C", "Nonprofit" - industry (string, enum): The company's main industry. This is the primary, structured way to filter companies by industry. Values: "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accommodation Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture, Construction, Mining Machinery Manufacturing", "Air, Water, and Waste Program Management", "Airlines and Aviation", "Alternative Dispute Resolution", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel Manufacturing", "Apparel and Fashion", "Appliances, Electrical, and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation & Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars, Taverns, and Nightclubs", "Bed-and-Breakfasts, Hostels, Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers, Tanks, and Shipping Container Manufacturing", "Book Publishing", "Book and Periodical Publishing", "Breweries", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Child Day Care Services", "Chiropractors", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting, Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial Real Estate", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computer and Network Security", "Computers and Electronics Manufacturing", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Defense & Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "E-Learning", "E-Learning Providers", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission, Control, and Distribution", "Electrical Equipment Manufacturing", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Farming, Ranching, Forestry", "Farming", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Flight Training", "Food & Beverages", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverage Services", "Food Production", "Footwear Manufacturing", "Forestry and Logging", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fundraising", "Funds and Trusts", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass Product Manufacturing", "Glass, Ceramics and Concrete Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "HVAC and Refrigeration Equipment Manufacturing", "Health and Human Services", "Health, Wellness and Fitness", "Higher Education", "Highway, Street, and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household Appliance Manufacturing", "Household Services", "Household and Institutional Furniture Manufacturing", "Housing Programs", "Housing and Community Development", "Human Resources", "Human Resources Services", "Hydroelectric Power Generation", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance Carriers", "Insurance and Employee Benefit Funds", "Interior Design", "International Affairs", "International Trade and Development", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Investment Advice", "Investment Banking", "Investment Management", "Janitorial Services", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure, Travel & Tourism", "Libraries", "Loan Brokers", "Luxury Goods and Jewelry", "Machinery Manufacturing", "Manufacturing", "Maritime", "Maritime Transportation", "Market Research", "Marketing Services", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical or Industrial Engineering", "Media & Telecommunications", "Media Production", "Medical Devices", "Medical Equipment Manufacturing", "Medical Practices", "Medical and Diagnostic Laboratories", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve, Ball, and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military and International Affairs", "Mining", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Gaming Apps", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies, Videos and Sound", "Museums", "Museums, Historical Sites, and Zoos", "Music", "Musicians", "Nanotechnology Research", "Natural Gas Distribution", "Newspaper Publishing", "Non-profit Organization Management", "Non-profit Organizations", "Nonmetallic Mineral Mining", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Gas", "Oil, Gas, and Mining", "Online Audio and Video Media", "Online Media", "Online and Mail Order Retail", "Operations Consulting", "Optometrists", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint, Coating, and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal Care Product Manufacturing", "Personal Care Services", "Personal and Laundry Services", "Pet Services", "Pharmaceutical Manufacturing", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical, Occupational and Speech Therapists", "Physicians", "Plastics Manufacturing", "Plastics and Rubber Product Manufacturing", "Political Organizations", "Primary Metal Manufacturing", "Primary and Secondary Education", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications Services", "Public Safety", "Radio and Television Broadcasting", "Rail Transportation", "Railroad Equipment Manufacturing", "Ranching", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables & Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances, Electrical, and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials & Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Rubber Products Manufacturing", "Satellite Telecommunications", "School and Employee Bus Services", "Seafood Product Manufacturing", "Securities and Commodity Exchanges", "Security Guards and Patrol Services", "Security Systems Services", "Security and Investigations", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports Teams and Clubs", "Sports and Recreation Instruction", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology, Information and Internet", "Technology, Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation Programs", "Transportation, Logistics, Supply Chain and Storage", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water, Waste, Steam, and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances, Electrical, and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware, Plumbing, Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless Services", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" - naics_codes_2022 (string, enum, array): NAICS 2022 industry classification codes as numeric strings (2-6 digits). Matching is hierarchical: a code matches companies whose more specific codes fall under it (e.g. "5132" matches a company classified "513210"). Census publishes three 2-digit sectors as ranges: "31-33" (Manufacturing), "44-45" (Retail Trade), "48-49" (Transportation and Warehousing). Use = for one code, in for multiple, e.g. naics_codes_2022 in ("31-33", "541511"). Values: "11" (11: Agriculture, Forestry, Fishing and Hunting), "111" (111: Crop Production), "1111" (1111: Oilseed and Grain Farming), "11111" (11111: Soybean Farming), "111110" (111110: Soybean Farming), "11112" (11112: Oilseed (except Soybean) Farming), "111120" (111120: Oilseed (except Soybean) Farming), "11113" (11113: Dry Pea and Bean Farming), "111130" (111130: Dry Pea and Bean Farming), "11114" (11114: Wheat Farming), "111140" (111140: Wheat Farming), "11115" (11115: Corn Farming), "111150" (111150: Corn Farming), "11116" (11116: Rice Farming), "111160" (111160: Rice Farming), "11119" (11119: Other Grain Farming), "111191" (111191: Oilseed and Grain Combination Farming), "111199" (111199: All Other Grain Farming), "1112" (1112: Vegetable and Melon Farming), "11121" (11121: Vegetable and Melon Farming), … - hierarchy_status (string, enum): The company's position in a known corporate hierarchy. Use "Ultimate parent" for the top-level parent or "Subsidiary" for a company beneath an ultimate parent. Use = for one status or in for multiple, e.g. hierarchy_status in ("Subsidiary", "Ultimate parent"). Values: "Ultimate parent", "Subsidiary" - ai_industries (string, enum, array): AI-derived industry classification. Do NOT filter on this field unless the user explicitly asks for ai_industries — default vertical filtering uses industry. Use = for exact match, in for multiple. e.g. ai_industries = "Professional, Business and Legal Services". Values: "Agriculture, Forestry and Fisheries", "Automotive, Aerospace and Defense Manufacturing", "Education and Training", "Energy, Utilities and Environmental Services", "Finance and Insurance", "Healthcare and Life Sciences", "Hospitality, Food and Travel Services", "Industrial Manufacturing and Materials", "Media, Entertainment and Culture", "Non-Profit, Public Sector and Education (Non-Commercial)", "Personal and Home Services", "Professional, Business and Legal Services", "Real Estate and Construction", "Retail and Consumer Channels", "Software and IT", "Transportation and Logistics" - ai_subindustries (string, enum, array): AI-derived subindustry classification. Use = for exact match, in for multiple. e.g. ai_subindustries = "AI and ML Platforms". Values: "AI and ML Platforms", "Agriculture and Forestry Software", "Blockchain and Web3", "Carriers and ISPs", "Cloud and Infrastructure Software", "Consumer Software", "Data and Analytics Software", "Developer Tools and Platforms", "Enterprise Software Solutions", "Financial Services Software", "Government and Public Sector Software", "Hardware and Networking", "Healthcare Software", "IoT and Embedded Systems Software", "IT Services and Cybersecurity", "Manufacturing Software", "Metaverse, AR/VR and Other Emerging Platforms", "Quantum Computing Software", "Real Estate and PropTech Software", "Retail and Ecommerce Software", "Security and Identity Software", "Biotechnology and Pharmaceuticals", "Digital Health and Telemedicine", "Hospitals, Clinics and Outpatient Care", "Medical Devices and Diagnostic Equipment", "Medical Testing and Clinical Laboratories", "Mental Health and Rehabilitation Services", "Pharma Distribution and CRO Services", "Banking and Lending", "Capital Markets and Cryptocurrency", "Cryptocurrency and Blockchain Services", "Financial Services Platforms", "Insurance and InsurTech", "Investment Management and WealthTech", "Venture Capital and Private Equity", "Electric Power and Grid Management", "Nuclear and Advanced Generation", "Oil and Gas Exploration, Production and Services", "Renewable Energy and Clean Tech", "Sustainability Tech and Environmental Consulting", "Water, Waste and Environmental Management", "3D Printing and Advanced Manufacturing", "Building Materials and Chemicals", "Consumer Goods and Appliances", "Electronics and Computer Equipment", "Food, Beverage and Tobacco Production", "Industrial Machinery and Equipment", "Mining, Metals and Natural Resources", "Architecture, Urban Planning and Green Building", "Commercial Real Estate Development and Leasing", "Construction and Civil Engineering Services", "Property and Facility Management", "Residential Real Estate Development and Brokerage", "Specialty Construction Products", "Automotive Service and Collision Repair", "Brick-and-Mortar Retail", "Media and Entertainment Retail", "Online Commerce and Marketplaces", "Retail Technology", "Specialty Auctions and Collectibles", "Wholesale and Distribution", "Autonomous Vehicles and Drone Delivery", "Car and Truck Rental", "Freight and Cargo", "Logistics Technology", "Passenger Transit and Mobility", "Warehousing, Fulfillment and 3PL Services", "Accounting, Audit and Financial Advisory", "Advertising, Marketing and Multimedia Design", "Defense and Government Services", "Facilities Management and Commercial Cleaning", "Human Resources, Staffing and Recruitment", "Legal Services and Regulatory Compliance", "Management Consulting and Strategy Consulting", "Translation, Document and Information Management", "Corporate Training and Learning and Development", "E-Learning Platforms and EdTech", "K-12 and Higher Education Institutions", "Test Prep, Tutoring and After-School Services", "Vocational Training and Certification Programs", "Digital Publishing and Streaming Platforms", "Film, Television and Broadcasting", "Gaming, Esports and Interactive Entertainment", "Live Events, Experiences and Ticketed Attractions", "Museums, Art Galleries and Cultural Preservation", "Music, Audio and Podcast Services", "Sports and Recreation", "Food and Beverage Services", "Hospitality and Lodging", "Travel Agencies and Leisure Services", "Funeral Homes and Related Services", "Home Services", "Personal Care and Wellness", "Veterinary Care and Pet Services", "AgriTech and Precision Farming", "Aquaculture and Fisheries", "Crop Farming and Livestock Production", "Farming Equipment and Supplies", "Forestry, Logging and Wood Products", "Mining and Extraction", "Aviation and Aerospace Component Manufacturing", "Automotive and Rental Retail", "Commercial Space Innovation", "Defense Systems and Marine Manufacturing", "Motor Vehicle and Parts Manufacturing", "Government Administration and Municipal Services", "NGOs, Charities and Community Organizations", "Public Healthcare and Social Services", "Public/Private Research Institutions and Educational Foundations", "Student Organizations and Campus Services" - ai_revenue_streams (string, enum, array): AI-derived revenue stream classification. Do NOT filter on this field unless the user explicitly asks for revenue streams. Use = for exact match, in for multiple. e.g. ai_revenue_streams = "SaaS". Values: "Professional Services", "Financial Services", "Subscriptions/Recurring", "Product Sales", "Transaction Fees", "Rental/Leasing", "Project/Contract Work", "Event/Experience Revenue", "Grants/Donations", "Licensing/IP", "Advertising" - locations (tuple array): All office locations. Use .any() or .count() with inner predicates on subfields. Subfields: - country_name (string, enum): Full country name, e.g. 'United States', 'Germany'. Values: "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Saint Eustatius and Saba ", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Colombia", "Comoros", "Costa Rica", "Croatia", "Cuba", "Curacao", "Cyprus", "Czechia", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Estonia", "Ethiopia", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Ivory Coast", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "North Korea", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Reunion", "Romania", "Russia", "Rwanda", "Saint Barthelemy", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Serbia and Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "U.S. Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" - city (string): City name, e.g. 'San Francisco', 'Berlin'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - state_or_province (string): State, province, or first-level administrative district, e.g. 'California', 'Ontario'. - postal_code (string): Postal or ZIP code, e.g. '94107'. - region (string, enum): Business region for the office location. Values: "APAC", "EMEA", "LATAM", "NAM" - is_headquarters (boolean): True when this location is the company headquarters (primary office). - technographics (tuple array): Technology stack installed at the company, backed by BuyerCaddy data. Use .any() or .count() with inner predicates on subfields. Subfields: - vendor (string): Technology vendor name. Common: "Microsoft", "Google", "Amazon", "Adobe", "Oracle", "The PHP Group", "Facebook, Inc.", "Automattic Inc.", "Cloudflare", "Apache", "Meta Platforms, Inc" - product (string): Product name. Common: "Amazon Web Services (AWS)", "Amazon Web Hosting", "Google Analytics 360", "PHP", "Google Tag Manager", "Microsoft 365 Apps & Services", "Google Marketing Platform", "Amazon EC2", "Microsoft Exchange", "GoDaddy Hosting" - product_category (string): Top-level product category. Common: "IT Infrastructure", "Collaboration & Productivity", "Marketing", "Development", "Content Management", "Digital Advertising Tech", "Hosting", "CI/CD Tools", "Cloud Data Integration", "Web Hosting" - product_subcategory (string): Most specific product category for an install, normally a child of product_category. The provider may supply one or two category levels; when it supplies one, the value lands here and product_category is empty. Populated more consistently than product_category. Common: "Operating System", "Cloud Infrastructure Automation", "iPaaS", "Collaboration & Productivity", "Digital Analytics", "Tag Management Systems", "Paid Search Advertising", "Office Suites", "Infrastructure as a Service (IaaS)", "Web Content Management" ### People predicate fields (inside `people.exists(...)` / `people.count(...)`) - job_title (string): Job title of the experience. Common: "Academic Counselor", "Accountant", "Account Executive", "Accounting Analyst", "Accounting Clerk", "Accounting Manager", "Accounting Partner", "Accounting Supervisor", "Account Manager", "Account Representative", "Accounts Payable Clerk", "Accounts Payable Manager", "Accounts Receivable Clerk", "Accounts Receivable Manager", "Account Supervisor", "Activities Director", "Activities Worker", "Actor", "Actuary", "Acupuncturist", … - description (string): Experience description text. Use contains for keyword matching. - company_name (string): Company name for the experience. - employment_type (string): Type of employment. Common: "Full-time", "Part-time", "Internship", "Self-employed", "Contract", "Permanent", "Freelance", "Volunteer", "Other", "Temporary", "Apprenticeship" - seniority (string, enum): Seniority level of the role. Values: "Founder", "Owner", "Board Member" (Board member), "Partner", "C-suite", "VP", "Director", "Head", "Manager", "Senior", "Mid-level", "Entry", "Intern / In Training" (Intern / in training), "Unknown" - is_current (boolean): True if this is the person's current role, false for past roles. In `experiences.any(...)` on people queries, omit `is_current` to match any tenure. In `people.exists(...)` / `people.count(...)` on companies queries, include `is_current = true` by default when the user doesn't specify between current vs past. - start_date (month): Date the experience started (YYYY-MM). - end_date (month): Date the experience ended (YYYY-MM). Empty if current role. - location (string): Free-text location of the experience. - location_city (string): City of the experience, e.g. 'San Francisco'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - location_state (string): State or province of the experience, e.g. 'California'. - location_country (string, enum): Country of the experience, e.g. 'United States'. Values: "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Collectivity of Saint Martin", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibralta", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea-Bissau", "Guinea", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Réunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" - location_region (string, enum): Geographic region of the experience. Values: "APAC", "EMEA", "LATAM", "NAM" - person.location_city (string): City where the person is located (their profile location, not the experience's), e.g. 'San Francisco'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - person.location_state (string): State or province where the person is located (their profile location, not the experience's), e.g. 'California'. - person.location_country (string, enum): Country where the person is located (their profile location, not the experience's), e.g. 'United States'. Values: "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Collectivity of Saint Martin", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibralta", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea-Bissau", "Guinea", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Réunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" - person.location_region (string, enum): Geographic region where the person is located (their profile location, not the experience's). Values: "APAC", "EMEA", "LATAM", "NAM" - person.headline (string): Profile headline (the tagline below their name). Use contains for keyword matching. - person.about (string): About/summary section of the profile. Use contains for keyword matching. - person.languages (string, array): Languages listed on the person's profile. Use = for exact match, in for multiple. e.g. person.languages = "Spanish". Common: "English", "Spanish", "French", "German", "Portuguese", "Chinese", "Japanese", "Hindi", "Arabic", "Korean", "Italian", "Dutch", "Russian" - person.years_of_experience (number): Estimated full-time years of experience based on full-time roles on the profile. - person.full_name (string): Full name of the person (first and last). - person.network_size (number): Estimated professional network size (connection count). - person.estimated_follower_count (number): Estimated social media audience/follower count. - person.education (tuple array): The person's education history (school, degree, field of study, dates, description, activities). Use person.education.any(...) or person.education.count(...) with inner predicates on subfields. Subfields: - school_name (string): Name of the school or university. - degree (string): Degree obtained, e.g. 'Bachelor of Science', 'Master of Business Administration', 'PhD'. - field_of_study (string): Academic major or field, e.g. 'Computer Science', 'Economics', 'Mechanical Engineering'. - start_date (month): Date education started (YYYY-MM). - end_date (month): Date education ended (YYYY-MM). - description (string): Education description text. Use contains for keyword matching. - activities_and_societies (string): Activities and societies during education. Use contains for keyword matching. ### Jobs predicate fields (inside `jobs.exists(...)` / `jobs.count(...)`) - job_title (string): Job posting title. Common: "Academic Counselor", "Accountant", "Account Executive", "Accounting Analyst", "Accounting Clerk", "Accounting Manager", "Accounting Partner", "Accounting Supervisor", "Account Manager", "Account Representative", "Accounts Payable Clerk", "Accounts Payable Manager", "Accounts Receivable Clerk", "Accounts Receivable Manager", "Account Supervisor", "Activities Director", "Activities Worker", "Actor", "Actuary", "Acupuncturist", … - job_description (string): Full job description text. Use contains for keyword matching. - employment_type (string, enum): Type of employment. Values: "Full-time", "Part-time", "Contract", "Internship", "Temporary", "Other", "Volunteer" - seniority (string, enum): Seniority level of the job posting. Values: "Executive", "Entry level", "Mid-Senior level", "Not Applicable", "Internship", "Associate", "Director" - location (string): Free-text job location. - job_posted_date (date): Date the job was posted. - job_removed_date (date): Date the job listing was removed. - job_still_open (boolean): True if the job posting is currently open, false if it closed within the last 6 months. Default to `job_still_open = true` unless the user explicitly asks for past/closed/historical postings, or asks about job posting history over a time range. - recruiter_name (string): Name of the recruiter for this posting. ## Examples | User says | dslQuery | |-----------|----------| | "fintech companies in NYC with 50-200 employees" | `select from companies where industry in ("Financial Services", "Banking") and estimated_employee_count >= 50 and estimated_employee_count <= 200 and locations.any(city = "New York")` | | "Series B SaaS companies using Salesforce" | `select from companies where industry = "Software Development" and latest_funding_type = "Series B" and technographics.any(vendor = "Salesforce")` | | "companies like Notion" | `select from companies where products_and_services is_similar_to ("collaborative docs and knowledge management")` | | "50 healthcare companies in Germany" | `select from companies where industry = "Hospitals and Health Care" and locations.any(country_name = "Germany") limit 50` | ## Response Behavior - Summarize the result briefly (e.g. "Found 25 fintech companies in NYC"). - The tool returns a taskId for use with add-company-data-points, custom functions, or get-task-context. Clay may render results in a widget in hosts that support MCP Apps, such as ChatGPT, claude.ai, and Cursor. Other terminal/coding-agent hosts such as Codex, Claude Code, Windsurf, and CLI environments do not show the widget. If you are unsure whether the widget is visible, assume it is not visible. - If a widget is visible, avoid repeating the full widget contents unless the user asks for full contents; then call get-task-context with the taskId and answer inline. - In terminal/coding-agent environments, when no widget is visible, or when the user asks for actual values/results, call get-task-context with the taskId and answer inline. - **NEVER tell the user that data was not found, not returned, or unavailable without first calling get-task-context.** The initial search/tool response only includes base fields — enrichment results (emails, X/Twitter profiles, work history, custom data points, etc.) are only available via get-task-context. - **When the user asks about a specific value** (e.g. "what's Patrick's email?", "what X profiles did you get?"), call get-task-context FIRST to check if the data has already been enriched — the user may have triggered enrichments through the widget. Only call add-contact-data-points / add-company-data-points if get-task-context shows the enrichment hasn't been run yet. - Use get-task-context to poll until async results complete; if values are still in-progress, wait and retry rather than answering with missing values. - If get-task-context is not available, fall back to get-task. ## Displaying Results This tool returns data only, and this client has no results widget. Present the results yourself, concisely — a compact list or table of the returned records with the fields the user cares about (e.g. name, title, company, LinkedIn URL). When the search reports `hasMore: true` and the user wants more, call `load-more-search-results` with the returned `taskId`. ## Enrichment This tool does NOT enrich (it takes no data points). To add custom research data points, call `add-contact-data-points` (for contacts) or `add-company-data-points` (for companies) with the returned `taskId` after this tool.
Inputs
dslQuerystringrequired
A Search DSL query. Must start with `select from companies`.
claymcp_search_contactsSearch for contacts (people) by role, title, seniority, location, or employer, expressed as a Search DSL query.Read-only
Search Contacts
Search for contacts (people) by role, title, seniority, location, or employer, expressed as a Search DSL query. Searches PUBLICLY AVAILABLE people data — it is NOT the user's own CRM. ## Quick Reference - **This tool**: Find TYPES of people (e.g. "engineers at Stripe", "VPs of Sales at Ramp and Brex"). - **search-contacts-by-name**: Find SPECIFIC named people (e.g. "John Smith at Stripe"). - **search-companies**: Find LISTS of companies. - **query-objects** + **ask-question-about-accounts**: the user's OWN accounts/deals/CRM. - **Follow-ups**: ALWAYS re-call this tool with an updated query — never filter results in chat. ## Parameters ### companyIdentifiers (required) One or more company domains or LinkedIn company URLs (up to 10). The backend applies these companies as an employer filter using companyTenure. Do NOT include `clay.filter_to_companies(...)` in dslQuery. ### companyTenure (optional, default "current") - "current": people who work at companyIdentifiers now. - "past": people who used to work at companyIdentifiers and no longer do ("former", "ex-", "alumni", "used to work at"). - "current_or_past": people who work there now or used to ("ever worked at"). ### dslQuery (required) A Search DSL query that MUST start with `select from people`. Include the requested person, role, seniority, location, and tenure filters; companyIdentifiers are attached separately by the backend. ## Search DSL Write a single Search DSL query. Grammar: ``` query = "select" "from" entity where? limit_by? limit? entity = "people" | "companies" where = "where" predicate limit_by = "limit" POSITIVE_INT "by" "clay_company_id" (people only) limit = "limit" INTEGER predicate = or_expr or_expr = and_expr ("or" and_expr)* and_expr = unary ("and" unary)* unary = "not" unary | comparison | aggregate | "(" predicate ")" comparison = field op value | field "is_null" | field "is_not_null" op = "=" | "!=" | "<" | "<=" | ">" | ">=" | "contains" | "starts_with" | "ends_with" | "in" | "not_in" | "is_similar_to" value = STRING | NUMBER | BOOLEAN | "(" value ("," value)* ")" | date_expr date_expr = "today" "(" ")" (("+" | "-") "interval" POSITIVE_INT unit)? unit = "day[s]" | "week[s]" | "month[s]" | "year[s]" ``` ### Operators - `contains` is whole-token match (not substring); list form: `field contains ("a", "b")`. - `in` / `not_in` take a value list; enum fields support only `=`, `!=`, `in`, `not_in`. - `is_similar_to` expands meaning (e.g. `job_title is_similar_to ("VP Sales")`). - `and` binds tighter than `or`; group with parentheses. ### Limits - Add `limit N` only when the user asks for a specific total count. - `limit N by clay_company_id` (people queries only) caps results per company. ### Company-scoped searches - Pass every requested employer through companyIdentifiers. - Add role/seniority/tenure with `experiences.any(is_current = true and ...)`. For a role held at a past employer (companyTenure "past"), use `is_current = false` instead; `is_current = true` would match people who hold the role at their new company. - For a per-company cap ("N per company"), add `limit N by clay_company_id`. - Filtering people by their employer's ATTRIBUTES (industry, size, funding) uses `company.*` inside experiences.any(...) — this is an advanced cross-entity filter and may require a paid plan. ### People fields (top-level in `select from people`) - full_name (string): Full name of the person (first and last). - location_city (string): City name, e.g. 'San Francisco', 'Berlin'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - location_state (string): State, province, or municipality, e.g. 'California', 'Ontario'. - location_country (string, enum): Full country name, e.g. 'United States', 'Germany'. Values: "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Collectivity of Saint Martin", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibralta", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea-Bissau", "Guinea", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Réunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" - location_region (string, enum): Geographic region. Values: "APAC", "EMEA", "LATAM", "NAM" - estimated_follower_count (number): Estimated social media audience/follower count. - network_size (number): Estimated professional network size (connection count). - years_of_experience (number): Estimated full-time years of experience based on full-time roles on the profile. - headline (string): Profile headline (the tagline below their name). Use contains for keyword matching. - about (string): About/summary section of the profile. Use contains for keyword matching. - languages (string, array): Languages listed on the profile. Use = for exact match, in for multiple. e.g. languages = "Spanish" or languages in ("Spanish", "French"). Common: "English", "Spanish", "French", "German", "Portuguese", "Chinese", "Japanese", "Hindi", "Arabic", "Korean", "Italian", "Dutch", "Russian" - education (tuple array): Education history. Use .any() or .count() with inner predicates on subfields. Subfields: - school_name (string): Name of the school or university. - degree (string): Degree obtained, e.g. 'Bachelor of Science', 'Master of Business Administration', 'PhD'. - field_of_study (string): Academic major or field, e.g. 'Computer Science', 'Economics', 'Mechanical Engineering'. - start_date (month): Date education started (YYYY-MM). - end_date (month): Date education ended (YYYY-MM). - description (string): Education description text. Use contains for keyword matching. - activities_and_societies (string): Activities and societies during education. Use contains for keyword matching. ### Experience fields (inside `experiences.any(...)`) - job_title (string): Job title of the experience. Common: "Academic Counselor", "Accountant", "Account Executive", "Accounting Analyst", "Accounting Clerk", "Accounting Manager", "Accounting Partner", "Accounting Supervisor", "Account Manager", "Account Representative", "Accounts Payable Clerk", "Accounts Payable Manager", "Accounts Receivable Clerk", "Accounts Receivable Manager", "Account Supervisor", "Activities Director", "Activities Worker", "Actor", "Actuary", "Acupuncturist", … - description (string): Experience description text. Use contains for keyword matching. - company_name (string): Company name for the experience. - employment_type (string): Type of employment. Common: "Full-time", "Part-time", "Internship", "Self-employed", "Contract", "Permanent", "Freelance", "Volunteer", "Other", "Temporary", "Apprenticeship" - seniority (string, enum): Seniority level of the role. Values: "Founder", "Owner", "Board Member" (Board member), "Partner", "C-suite", "VP", "Director", "Head", "Manager", "Senior", "Mid-level", "Entry", "Intern / In Training" (Intern / in training), "Unknown" - is_current (boolean): True if this is the person's current role, false for past roles. In `experiences.any(...)` on people queries, omit `is_current` to match any tenure. In `people.exists(...)` / `people.count(...)` on companies queries, include `is_current = true` by default when the user doesn't specify between current vs past. - start_date (month): Date the experience started (YYYY-MM). - end_date (month): Date the experience ended (YYYY-MM). Empty if current role. - location (string): Free-text location of the experience. - location_city (string): City of the experience, e.g. 'San Francisco'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - location_state (string): State or province of the experience, e.g. 'California'. - location_country (string, enum): Country of the experience, e.g. 'United States'. Values: "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Collectivity of Saint Martin", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands (Malvinas)", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibralta", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea-Bissau", "Guinea", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Réunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States Minor Outlying Islands", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Virgin Islands, British", "Virgin Islands, U.S.", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" - location_region (string, enum): Geographic region of the experience. Values: "APAC", "EMEA", "LATAM", "NAM" ### Employer fields (inside `experiences.any(... company.* ...)`) - domain (string): Company website domain, e.g. 'google.com', 'stripe.com'. - description (string): Company description. Use contains for keyword matching. - products_and_services (string): What the company does, makes, and sells, matched semantically against company document embeddings. Only supports is_similar_to with one or more non-empty string values; multiple values match companies similar to ANY value (e.g. products_and_services is_similar_to ("b2b saas", "crm")). Distinct from description keyword matching; not all companies have embeddings, and rows without one never match. - company_type (string, enum): Company type classification. Values: "Privately Held" (Privately held), "Public Company" (Public company), "Partnership", "Self Employed" (Self-employed), "Non Profit" (Nonprofit), "Educational", "Self Owned" (Self-owned), "Government Agency" (Government agency) - company_size (string, enum): Company size range bucket. Prefer this for first-pass company-size filtering; use estimated_employee_count only when the user explicitly asks for exact employee count/headcount. Values: "1" (1 employee), "2-10" (2–10 employees), "11-50" (11–50 employees), "51-200" (51–200 employees), "201-500" (201–500 employees), "501-1,000" (501–1,000 employees), "1,001-5,000" (1,001–5,000 employees), "5,001-10,000" (5,001–10,000 employees), "10,001+" (10,001+ employees) - estimated_employee_count (number): Estimated total employee count. Use only when the user explicitly asks for exact employee count/headcount or asks to switch from company-size buckets to exact counts. - estimated_follower_count (number): Estimated social media audience/follower count. - year_founded (year): Year the company was founded. - employee_growth_3mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_6mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_12mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - employee_growth_24mo (number): Employee growth ratio (1.1 = +10% growth, 0.9 = −10% decline). - annual_revenue (string, enum): Annual revenue bracket. Use = or in with exact bucket values, not numeric operators. Values: "0-500K" ($0–$500K), "500K-1M" ($500K–$1M), "1M-5M" ($1M–$5M), "5M-10M" ($5M–$10M), "10M-25M" ($10M–$25M), "25M-75M" ($25M–$75M), "75M-200M" ($75M–$200M), "200M-500M" ($200M–$500M), "500M-1B" ($500M–$1B), "1B-10B" ($1B–$10B), "10B-100B" ($10B–$100B), "100B-1T" ($100B+) - ai_business_types (string): Derived business model type. LOW COVERAGE — treat as optional: always pair with an is_null fallback, e.g. (ai_business_types contains "B2B" or ai_business_types is_null). Use contains for matching. Common: "B2B", "B2C", "Nonprofit" - industry (string, enum): The company's main industry. This is the primary, structured way to filter companies by industry. Values: "Abrasives and Nonmetallic Minerals Manufacturing", "Accessible Architecture and Design", "Accommodation Services", "Accounting", "Administration of Justice", "Administrative and Support Services", "Advertising Services", "Agricultural Chemical Manufacturing", "Agriculture, Construction, Mining Machinery Manufacturing", "Air, Water, and Waste Program Management", "Airlines and Aviation", "Alternative Dispute Resolution", "Alternative Medicine", "Ambulance Services", "Amusement Parks and Arcades", "Animal Feed Manufacturing", "Animation", "Animation and Post-production", "Apparel Manufacturing", "Apparel and Fashion", "Appliances, Electrical, and Electronics Manufacturing", "Architectural and Structural Metal Manufacturing", "Architecture and Planning", "Armed Forces", "Artists and Writers", "Arts and Crafts", "Audio and Video Equipment Manufacturing", "Automation Machinery Manufacturing", "Automotive", "Aviation & Aerospace", "Aviation and Aerospace Component Manufacturing", "Baked Goods Manufacturing", "Banking", "Bars, Taverns, and Nightclubs", "Bed-and-Breakfasts, Hostels, Homestays", "Beverage Manufacturing", "Biomass Electric Power Generation", "Biotechnology", "Biotechnology Research", "Blockchain Services", "Blogs", "Boilers, Tanks, and Shipping Container Manufacturing", "Book Publishing", "Book and Periodical Publishing", "Breweries", "Broadcast Media Production and Distribution", "Building Construction", "Building Equipment Contractors", "Building Finishing Contractors", "Building Materials", "Building Structure and Exterior Contractors", "Business Consulting and Services", "Business Content", "Business Intelligence Platforms", "Business Supplies and Equipment", "Capital Markets", "Caterers", "Chemical Manufacturing", "Chemical Raw Materials Manufacturing", "Child Day Care Services", "Chiropractors", "Civic and Social Organizations", "Civil Engineering", "Claims Adjusting, Actuarial Services", "Clay and Refractory Products Manufacturing", "Climate Data and Analytics", "Climate Technology Product Manufacturing", "Coal Mining", "Collection Agencies", "Commercial Real Estate", "Commercial and Industrial Equipment Rental", "Commercial and Industrial Machinery Maintenance", "Commercial and Service Industry Machinery Manufacturing", "Communications Equipment Manufacturing", "Community Development and Urban Planning", "Community Services", "Computer Games", "Computer Hardware", "Computer Hardware Manufacturing", "Computer Networking", "Computer Networking Products", "Computer and Network Security", "Computers and Electronics Manufacturing", "Conservation Programs", "Construction", "Construction Hardware Manufacturing", "Consumer Electronics", "Consumer Goods", "Consumer Goods Rental", "Consumer Services", "Cosmetics", "Cosmetology and Barber Schools", "Courts of Law", "Credit Intermediation", "Dairy", "Dairy Product Manufacturing", "Dance Companies", "Data Infrastructure and Analytics", "Data Security Software Products", "Defense & Space", "Defense and Space Manufacturing", "Dentists", "Design", "Design Services", "Desktop Computing Software Products", "Digital Accessibility Services", "Distilleries", "E-Learning", "E-Learning Providers", "Economic Programs", "Education", "Education Administration Programs", "Education Management", "Electric Lighting Equipment Manufacturing", "Electric Power Generation", "Electric Power Transmission, Control, and Distribution", "Electrical Equipment Manufacturing", "Electronic and Precision Equipment Maintenance", "Embedded Software Products", "Emergency and Relief Services", "Engineering Services", "Engines and Power Transmission Equipment Manufacturing", "Entertainment", "Entertainment Providers", "Environmental Quality Programs", "Environmental Services", "Equipment Rental Services", "Events Services", "Executive Offices", "Executive Search Services", "Fabricated Metal Products", "Facilities Services", "Farming, Ranching, Forestry", "Farming", "Fashion Accessories Manufacturing", "Financial Services", "Fine Art", "Fine Arts Schools", "Fire Protection", "Fisheries", "Flight Training", "Food & Beverages", "Food and Beverage Manufacturing", "Food and Beverage Retail", "Food and Beverage Services", "Food Production", "Footwear Manufacturing", "Forestry and Logging", "Freight and Package Transportation", "Fruit and Vegetable Preserves Manufacturing", "Fundraising", "Funds and Trusts", "Furniture", "Furniture and Home Furnishings Manufacturing", "Gambling Facilities and Casinos", "Geothermal Electric Power Generation", "Glass Product Manufacturing", "Glass, Ceramics and Concrete Manufacturing", "Golf Courses and Country Clubs", "Government Administration", "Government Relations", "Government Relations Services", "Graphic Design", "Ground Passenger Transportation", "HVAC and Refrigeration Equipment Manufacturing", "Health and Human Services", "Health, Wellness and Fitness", "Higher Education", "Highway, Street, and Bridge Construction", "Historical Sites", "Holding Companies", "Home Health Care Services", "Horticulture", "Hospitality", "Hospitals", "Hospitals and Health Care", "Hotels and Motels", "Household Appliance Manufacturing", "Household Services", "Household and Institutional Furniture Manufacturing", "Housing Programs", "Housing and Community Development", "Human Resources", "Human Resources Services", "Hydroelectric Power Generation", "IT Services and IT Consulting", "IT System Custom Software Development", "IT System Data Services", "IT System Design Services", "IT System Installation and Disposal", "IT System Operations and Maintenance", "IT System Testing and Evaluation", "IT System Training and Support", "Import and Export", "Individual and Family Services", "Industrial Automation", "Industrial Machinery Manufacturing", "Industry Associations", "Information Services", "Information Technology and Services", "Insurance", "Insurance Agencies and Brokerages", "Insurance Carriers", "Insurance and Employee Benefit Funds", "Interior Design", "International Affairs", "International Trade and Development", "Internet Marketplace Platforms", "Internet News", "Internet Publishing", "Investment Advice", "Investment Banking", "Investment Management", "Janitorial Services", "Landscaping Services", "Language Schools", "Laundry and Drycleaning Services", "Law Enforcement", "Law Practice", "Leasing Non-residential Real Estate", "Leasing Residential Real Estate", "Leather Product Manufacturing", "Legal Services", "Legislative Offices", "Leisure, Travel & Tourism", "Libraries", "Loan Brokers", "Luxury Goods and Jewelry", "Machinery Manufacturing", "Manufacturing", "Maritime", "Maritime Transportation", "Market Research", "Marketing Services", "Mattress and Blinds Manufacturing", "Measuring and Control Instrument Manufacturing", "Meat Products Manufacturing", "Mechanical or Industrial Engineering", "Media & Telecommunications", "Media Production", "Medical Devices", "Medical Equipment Manufacturing", "Medical Practices", "Medical and Diagnostic Laboratories", "Mental Health Care", "Metal Ore Mining", "Metal Treatments", "Metal Valve, Ball, and Roller Manufacturing", "Metalworking Machinery Manufacturing", "Military and International Affairs", "Mining", "Mobile Computing Software Products", "Mobile Food Services", "Mobile Gaming Apps", "Motor Vehicle Manufacturing", "Motor Vehicle Parts Manufacturing", "Movies and Sound Recording", "Movies, Videos and Sound", "Museums", "Museums, Historical Sites, and Zoos", "Music", "Musicians", "Nanotechnology Research", "Natural Gas Distribution", "Newspaper Publishing", "Non-profit Organization Management", "Non-profit Organizations", "Nonmetallic Mineral Mining", "Nonresidential Building Construction", "Nuclear Electric Power Generation", "Nursing Homes and Residential Care Facilities", "Office Administration", "Office Furniture and Fixtures Manufacturing", "Oil and Gas", "Oil, Gas, and Mining", "Online Audio and Video Media", "Online Media", "Online and Mail Order Retail", "Operations Consulting", "Optometrists", "Outpatient Care Centers", "Outsourcing and Offshoring Consulting", "Outsourcing/Offshoring", "Packaging and Containers", "Packaging and Containers Manufacturing", "Paint, Coating, and Adhesive Manufacturing", "Paper and Forest Product Manufacturing", "Paper and Forest Products", "Performing Arts", "Performing Arts and Spectator Sports", "Periodical Publishing", "Personal Care Product Manufacturing", "Personal Care Services", "Personal and Laundry Services", "Pet Services", "Pharmaceutical Manufacturing", "Philanthropic Fundraising Services", "Philanthropy", "Photography", "Physical, Occupational and Speech Therapists", "Physicians", "Plastics Manufacturing", "Plastics and Rubber Product Manufacturing", "Political Organizations", "Primary Metal Manufacturing", "Primary and Secondary Education", "Printing Services", "Professional Organizations", "Professional Services", "Professional Training and Coaching", "Program Development", "Public Assistance Programs", "Public Health", "Public Policy", "Public Policy Offices", "Public Relations and Communications Services", "Public Safety", "Radio and Television Broadcasting", "Rail Transportation", "Railroad Equipment Manufacturing", "Ranching", "Real Estate", "Real Estate Agents and Brokers", "Real Estate and Equipment Rental Services", "Recreational Facilities", "Religious Institutions", "Renewable Energy Equipment Manufacturing", "Renewable Energy Power Generation", "Renewable Energy Semiconductor Manufacturing", "Renewables & Environment", "Repair and Maintenance", "Research", "Research Services", "Residential Building Construction", "Restaurants", "Retail", "Retail Apparel and Fashion", "Retail Appliances, Electrical, and Electronic Equipment", "Retail Art Dealers", "Retail Art Supplies", "Retail Books and Printed News", "Retail Building Materials and Garden Equipment", "Retail Florists", "Retail Furniture and Home Furnishings", "Retail Gasoline", "Retail Groceries", "Retail Health and Personal Care Products", "Retail Luxury Goods and Jewelry", "Retail Motor Vehicles", "Retail Musical Instruments", "Retail Office Equipment", "Retail Office Supplies and Gifts", "Retail Pharmacies", "Retail Recyclable Materials & Used Merchandise", "Reupholstery and Furniture Repair", "Robotics Engineering", "Rubber Products Manufacturing", "Satellite Telecommunications", "School and Employee Bus Services", "Seafood Product Manufacturing", "Securities and Commodity Exchanges", "Security Guards and Patrol Services", "Security Systems Services", "Security and Investigations", "Semiconductor Manufacturing", "Semiconductors", "Services for Renewable Energy", "Services for the Elderly and Disabled", "Sheet Music Publishing", "Shipbuilding", "Shuttles and Special Needs Transportation Services", "Sightseeing Transportation", "Soap and Cleaning Product Manufacturing", "Social Networking Platforms", "Software Development", "Solar Electric Power Generation", "Sound Recording", "Space Research and Technology", "Specialty Trade Contractors", "Spectator Sports", "Sporting Goods", "Sporting Goods Manufacturing", "Sports Teams and Clubs", "Sports and Recreation Instruction", "Spring and Wire Product Manufacturing", "Staffing and Recruiting", "Steam and Air-Conditioning Supply", "Strategic Management Services", "Subdivision of Land", "Sugar and Confectionery Product Manufacturing", "Surveying and Mapping Services", "Taxi and Limousine Services", "Technical and Vocational Training", "Technology, Information and Internet", "Technology, Information and Media", "Telecommunications", "Telecommunications Carriers", "Telephone Call Centers", "Temporary Help Services", "Textile Manufacturing", "Theater Companies", "Think Tanks", "Tobacco", "Tobacco Manufacturing", "Translation and Localization", "Transportation Equipment Manufacturing", "Transportation Programs", "Transportation, Logistics, Supply Chain and Storage", "Transportation/Trucking/Railroad", "Travel Arrangements", "Truck Transportation", "Trusts and Estates", "Turned Products and Fastener Manufacturing", "Urban Transit Services", "Utilities", "Utilities Administration", "Utility System Construction", "Vehicle Repair and Maintenance", "Venture Capital and Private Equity Principals", "Veterinary", "Veterinary Services", "Vocational Rehabilitation Services", "Warehousing", "Warehousing and Storage", "Waste Collection", "Waste Treatment and Disposal", "Water Supply and Irrigation Systems", "Water, Waste, Steam, and Air Conditioning Services", "Wellness and Fitness Services", "Wholesale", "Wholesale Alcoholic Beverages", "Wholesale Apparel and Sewing Supplies", "Wholesale Appliances, Electrical, and Electronics", "Wholesale Building Materials", "Wholesale Chemical and Allied Products", "Wholesale Computer Equipment", "Wholesale Drugs and Sundries", "Wholesale Food and Beverage", "Wholesale Footwear", "Wholesale Furniture and Home Furnishings", "Wholesale Hardware, Plumbing, Heating Equipment", "Wholesale Import and Export", "Wholesale Luxury Goods and Jewelry", "Wholesale Machinery", "Wholesale Metals and Minerals", "Wholesale Motor Vehicles and Parts", "Wholesale Paper Products", "Wholesale Petroleum and Petroleum Products", "Wholesale Raw Farm Products", "Wholesale Recyclable Materials", "Wind Electric Power Generation", "Wine and Spirits", "Wineries", "Wireless Services", "Wood Product Manufacturing", "Writing and Editing", "Zoos and Botanical Gardens" - naics_codes_2022 (string, enum, array): NAICS 2022 industry classification codes as numeric strings (2-6 digits). Matching is hierarchical: a code matches companies whose more specific codes fall under it (e.g. "5132" matches a company classified "513210"). Census publishes three 2-digit sectors as ranges: "31-33" (Manufacturing), "44-45" (Retail Trade), "48-49" (Transportation and Warehousing). Use = for one code, in for multiple, e.g. naics_codes_2022 in ("31-33", "541511"). Values: "11" (11: Agriculture, Forestry, Fishing and Hunting), "111" (111: Crop Production), "1111" (1111: Oilseed and Grain Farming), "11111" (11111: Soybean Farming), "111110" (111110: Soybean Farming), "11112" (11112: Oilseed (except Soybean) Farming), "111120" (111120: Oilseed (except Soybean) Farming), "11113" (11113: Dry Pea and Bean Farming), "111130" (111130: Dry Pea and Bean Farming), "11114" (11114: Wheat Farming), "111140" (111140: Wheat Farming), "11115" (11115: Corn Farming), "111150" (111150: Corn Farming), "11116" (11116: Rice Farming), "111160" (111160: Rice Farming), "11119" (11119: Other Grain Farming), "111191" (111191: Oilseed and Grain Combination Farming), "111199" (111199: All Other Grain Farming), "1112" (1112: Vegetable and Melon Farming), "11121" (11121: Vegetable and Melon Farming), … - hierarchy_status (string, enum): The company's position in a known corporate hierarchy. Use "Ultimate parent" for the top-level parent or "Subsidiary" for a company beneath an ultimate parent. Use = for one status or in for multiple, e.g. hierarchy_status in ("Subsidiary", "Ultimate parent"). Values: "Ultimate parent", "Subsidiary" - ai_industries (string, enum, array): AI-derived industry classification. Do NOT filter on this field unless the user explicitly asks for ai_industries — default vertical filtering uses industry. Use = for exact match, in for multiple. e.g. ai_industries = "Professional, Business and Legal Services". Values: "Agriculture, Forestry and Fisheries", "Automotive, Aerospace and Defense Manufacturing", "Education and Training", "Energy, Utilities and Environmental Services", "Finance and Insurance", "Healthcare and Life Sciences", "Hospitality, Food and Travel Services", "Industrial Manufacturing and Materials", "Media, Entertainment and Culture", "Non-Profit, Public Sector and Education (Non-Commercial)", "Personal and Home Services", "Professional, Business and Legal Services", "Real Estate and Construction", "Retail and Consumer Channels", "Software and IT", "Transportation and Logistics" - ai_subindustries (string, enum, array): AI-derived subindustry classification. Use = for exact match, in for multiple. e.g. ai_subindustries = "AI and ML Platforms". Values: "AI and ML Platforms", "Agriculture and Forestry Software", "Blockchain and Web3", "Carriers and ISPs", "Cloud and Infrastructure Software", "Consumer Software", "Data and Analytics Software", "Developer Tools and Platforms", "Enterprise Software Solutions", "Financial Services Software", "Government and Public Sector Software", "Hardware and Networking", "Healthcare Software", "IoT and Embedded Systems Software", "IT Services and Cybersecurity", "Manufacturing Software", "Metaverse, AR/VR and Other Emerging Platforms", "Quantum Computing Software", "Real Estate and PropTech Software", "Retail and Ecommerce Software", "Security and Identity Software", "Biotechnology and Pharmaceuticals", "Digital Health and Telemedicine", "Hospitals, Clinics and Outpatient Care", "Medical Devices and Diagnostic Equipment", "Medical Testing and Clinical Laboratories", "Mental Health and Rehabilitation Services", "Pharma Distribution and CRO Services", "Banking and Lending", "Capital Markets and Cryptocurrency", "Cryptocurrency and Blockchain Services", "Financial Services Platforms", "Insurance and InsurTech", "Investment Management and WealthTech", "Venture Capital and Private Equity", "Electric Power and Grid Management", "Nuclear and Advanced Generation", "Oil and Gas Exploration, Production and Services", "Renewable Energy and Clean Tech", "Sustainability Tech and Environmental Consulting", "Water, Waste and Environmental Management", "3D Printing and Advanced Manufacturing", "Building Materials and Chemicals", "Consumer Goods and Appliances", "Electronics and Computer Equipment", "Food, Beverage and Tobacco Production", "Industrial Machinery and Equipment", "Mining, Metals and Natural Resources", "Architecture, Urban Planning and Green Building", "Commercial Real Estate Development and Leasing", "Construction and Civil Engineering Services", "Property and Facility Management", "Residential Real Estate Development and Brokerage", "Specialty Construction Products", "Automotive Service and Collision Repair", "Brick-and-Mortar Retail", "Media and Entertainment Retail", "Online Commerce and Marketplaces", "Retail Technology", "Specialty Auctions and Collectibles", "Wholesale and Distribution", "Autonomous Vehicles and Drone Delivery", "Car and Truck Rental", "Freight and Cargo", "Logistics Technology", "Passenger Transit and Mobility", "Warehousing, Fulfillment and 3PL Services", "Accounting, Audit and Financial Advisory", "Advertising, Marketing and Multimedia Design", "Defense and Government Services", "Facilities Management and Commercial Cleaning", "Human Resources, Staffing and Recruitment", "Legal Services and Regulatory Compliance", "Management Consulting and Strategy Consulting", "Translation, Document and Information Management", "Corporate Training and Learning and Development", "E-Learning Platforms and EdTech", "K-12 and Higher Education Institutions", "Test Prep, Tutoring and After-School Services", "Vocational Training and Certification Programs", "Digital Publishing and Streaming Platforms", "Film, Television and Broadcasting", "Gaming, Esports and Interactive Entertainment", "Live Events, Experiences and Ticketed Attractions", "Museums, Art Galleries and Cultural Preservation", "Music, Audio and Podcast Services", "Sports and Recreation", "Food and Beverage Services", "Hospitality and Lodging", "Travel Agencies and Leisure Services", "Funeral Homes and Related Services", "Home Services", "Personal Care and Wellness", "Veterinary Care and Pet Services", "AgriTech and Precision Farming", "Aquaculture and Fisheries", "Crop Farming and Livestock Production", "Farming Equipment and Supplies", "Forestry, Logging and Wood Products", "Mining and Extraction", "Aviation and Aerospace Component Manufacturing", "Automotive and Rental Retail", "Commercial Space Innovation", "Defense Systems and Marine Manufacturing", "Motor Vehicle and Parts Manufacturing", "Government Administration and Municipal Services", "NGOs, Charities and Community Organizations", "Public Healthcare and Social Services", "Public/Private Research Institutions and Educational Foundations", "Student Organizations and Campus Services" - ai_revenue_streams (string, enum, array): AI-derived revenue stream classification. Do NOT filter on this field unless the user explicitly asks for revenue streams. Use = for exact match, in for multiple. e.g. ai_revenue_streams = "SaaS". Values: "Professional Services", "Financial Services", "Subscriptions/Recurring", "Product Sales", "Transaction Fees", "Rental/Leasing", "Project/Contract Work", "Event/Experience Revenue", "Grants/Donations", "Licensing/IP", "Advertising" - locations (tuple array): All office locations. Use .any() or .count() with inner predicates on subfields. Subfields: - country_name (string, enum): Full country name, e.g. 'United States', 'Germany'. Values: "Afghanistan", "Albania", "Algeria", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Saint Eustatius and Saba ", "Bosnia and Herzegovina", "Botswana", "Brazil", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Colombia", "Comoros", "Costa Rica", "Croatia", "Cuba", "Curacao", "Cyprus", "Czechia", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Estonia", "Ethiopia", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guyana", "Haiti", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Ivory Coast", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Macedonia", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Moldova", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "North Korea", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palestinian Territory", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Reunion", "Romania", "Russia", "Rwanda", "Saint Barthelemy", "Saint Kitts and Nevis", "Saint Lucia", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Serbia and Montenegro", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Togo", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "U.S. Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela", "Vietnam", "Yemen", "Zambia", "Zimbabwe" - city (string): City name, e.g. 'San Francisco', 'Berlin'. Common: "Aberdeen", "Abilene", "Akron", "Albany", "Albuquerque", "Alexandria", "Allentown", "Amarillo", "Anaheim", "Anchorage", "Ann Arbor", "Antioch", "Apple Valley", "Appleton", "Arlington", "Arvada", "Asheville", "Atlanta", "Atlantic City", "Augusta", … - state_or_province (string): State, province, or first-level administrative district, e.g. 'California', 'Ontario'. - postal_code (string): Postal or ZIP code, e.g. '94107'. - region (string, enum): Business region for the office location. Values: "APAC", "EMEA", "LATAM", "NAM" - is_headquarters (boolean): True when this location is the company headquarters (primary office). - technographics (tuple array): Technology stack installed at the company, backed by BuyerCaddy data. Use .any() or .count() with inner predicates on subfields. Subfields: - vendor (string): Technology vendor name. Common: "Microsoft", "Google", "Amazon", "Adobe", "Oracle", "The PHP Group", "Facebook, Inc.", "Automattic Inc.", "Cloudflare", "Apache", "Meta Platforms, Inc" - product (string): Product name. Common: "Amazon Web Services (AWS)", "Amazon Web Hosting", "Google Analytics 360", "PHP", "Google Tag Manager", "Microsoft 365 Apps & Services", "Google Marketing Platform", "Amazon EC2", "Microsoft Exchange", "GoDaddy Hosting" - product_category (string): Top-level product category. Common: "IT Infrastructure", "Collaboration & Productivity", "Marketing", "Development", "Content Management", "Digital Advertising Tech", "Hosting", "CI/CD Tools", "Cloud Data Integration", "Web Hosting" - product_subcategory (string): Most specific product category for an install, normally a child of product_category. The provider may supply one or two category levels; when it supplies one, the value lands here and product_category is empty. Populated more consistently than product_category. Common: "Operating System", "Cloud Infrastructure Automation", "iPaaS", "Collaboration & Productivity", "Digital Analytics", "Tag Management Systems", "Paid Search Advertising", "Office Suites", "Infrastructure as a Service (IaaS)", "Web Content Management" ## Examples | User says | companyIdentifiers | dslQuery | |-----------|--------------------|----------| | "engineers at Stripe" | `["stripe.com"]` | `select from people where experiences.any(is_current = true and job_title is_similar_to ("engineer"))` | | "up to 5 VPs of Sales at Stripe, Ramp, and Brex" | `["stripe.com", "ramp.com", "brex.com"]` | `select from people where experiences.any(is_current = true and job_title is_similar_to ("VP Sales")) limit 5 by clay_company_id` | | "new hires at Stripe in the last 3 months" | `["stripe.com"]` | `select from people where experiences.any(is_current = true and start_date >= today() - interval 3 months)` | | "former engineers at Stripe" | `["stripe.com"]`, companyTenure: "past" | `select from people where experiences.any(is_current = false and job_title is_similar_to ("engineer"))` | | "ex-Stripe people who are now VPs of Sales" | `["stripe.com"]`, companyTenure: "past" | `select from people where experiences.any(is_current = true and job_title is_similar_to ("VP Sales"))` | ## Handling Follow-ups ANY change to the search requires re-calling this tool with a modified query — never filter in chat. - "also / too" → add predicates with `and`, keeping prior filters. - "only / just" → narrow the relevant predicate. - "instead / actually" → replace the relevant predicate. - When ambiguous, ask the user. ## Response Behavior - Summarize the search briefly (e.g., "Found 20 engineers at OpenAI"). - The tool returns a taskId for use with add-contact-data-points, add-company-data-points, custom functions, or get-task-context. - For research questions about the results, use add-contact-data-points with the taskId. Clay may render results in a widget in hosts that support MCP Apps, such as ChatGPT, claude.ai, and Cursor. Other terminal/coding-agent hosts such as Codex, Claude Code, Windsurf, and CLI environments do not show the widget. If you are unsure whether the widget is visible, assume it is not visible. - If a widget is visible, avoid repeating the full widget contents unless the user asks for full contents; then call get-task-context with the taskId and answer inline. - In terminal/coding-agent environments, when no widget is visible, or when the user asks for actual values/results, call get-task-context with the taskId and answer inline. - **NEVER tell the user that data was not found, not returned, or unavailable without first calling get-task-context.** The initial search/tool response only includes base fields — enrichment results (emails, X/Twitter profiles, work history, custom data points, etc.) are only available via get-task-context. - **When the user asks about a specific value** (e.g. "what's Patrick's email?", "what X profiles did you get?"), call get-task-context FIRST to check if the data has already been enriched — the user may have triggered enrichments through the widget. Only call add-contact-data-points / add-company-data-points if get-task-context shows the enrichment hasn't been run yet. - Use get-task-context to poll until async results complete; if values are still in-progress, wait and retry rather than answering with missing values. - If get-task-context is not available, fall back to get-task. ## Zero Results Suggest broadening: relax role terms (is_similar_to already expands), drop location or tenure, or verify the companyIdentifiers. ## Displaying Results This tool returns data only, and this client has no results widget. Present the results yourself, concisely — a compact list or table of the returned records with the fields the user cares about (e.g. name, title, company, LinkedIn URL). When the search reports `hasMore: true` and the user wants more, call `load-more-search-results` with the returned `taskId`. ## Enrichment This tool does NOT enrich (it takes no data points). To add custom research data points, call `add-contact-data-points` (for contacts) or `add-company-data-points` (for companies) with the returned `taskId` after this tool.
Inputs
companyIdentifiersarrayrequired
One or more company identifiers to search contacts at (up to 10). Each is a domain (e.g. "clay.com") or a LinkedIn company URL (e.g. "https://www.linkedin.com/company/grow-with-clay"). Pass multiple to run the same role/title filters across several companies at once.
dslQuerystringrequired
A Search DSL query. Must start with `select from people`.
companyTenurestring
Whether people must currently work at, have previously worked at, or currently or previously work at companyIdentifiers. Defaults to current.one of currentpastcurrent_or_past
claymcp_search_contacts_by_nameFind and enrich specific named contacts at their companies.Read-only
Search Contacts By Name
Find and enrich specific named contacts at their companies. ## Quick Reference - **This tool**: Find SPECIFIC named people (e.g., "John Smith at OpenAI", "Jane Doe at Stripe") - **search-contacts**: Find TYPES of people (e.g., "engineers at Stripe") - Do NOT use if user only provides company names without contact names - Do NOT use to enrich contacts already in an existing search — use **add-contact-data-points** with entityIds instead ## Parameters ### contacts (required) Array of { contactName, companyIdentifier } objects. - **contactName**: First name, last name, or full name (e.g., "John", "Smith", or "John Smith") - **companyIdentifier**: Domain or company LinkedIn URL (NOT person LinkedIn URLs) - Domains: "openai.com", "stripe.com" - LinkedIn: "linkedin.com/company/openai" - Company names: Convert if confident (e.g., "Stripe" → "stripe.com"), otherwise ask user ## Examples | User request | contacts | |--------------|----------| | "Find John Smith at OpenAI" | [{ contactName: "John Smith", companyIdentifier: "openai.com" }] | | "Look up Jane Doe at Stripe and Bob Lee at Figma" | [{ contactName: "Jane Doe", companyIdentifier: "stripe.com" }, { contactName: "Bob Lee", companyIdentifier: "figma.com" }] | ## Follow-ups - "Add [name] at [company] too" → Re-call with ALL contacts (previous + new) - "Actually look up [different people]" → Re-call with only the new contacts ## Response Behavior - Summarize the search briefly (e.g., "Found 20 engineers at OpenAI"). - The tool returns a taskId for use with add-contact-data-points, add-company-data-points, custom functions, or get-task-context. - For research questions about the results, use add-contact-data-points with the taskId. Clay may render results in a widget in hosts that support MCP Apps, such as ChatGPT, claude.ai, and Cursor. Other terminal/coding-agent hosts such as Codex, Claude Code, Windsurf, and CLI environments do not show the widget. If you are unsure whether the widget is visible, assume it is not visible. - If a widget is visible, avoid repeating the full widget contents unless the user asks for full contents; then call get-task-context with the taskId and answer inline. - In terminal/coding-agent environments, when no widget is visible, or when the user asks for actual values/results, call get-task-context with the taskId and answer inline. - **NEVER tell the user that data was not found, not returned, or unavailable without first calling get-task-context.** The initial search/tool response only includes base fields — enrichment results (emails, X/Twitter profiles, work history, custom data points, etc.) are only available via get-task-context. - **When the user asks about a specific value** (e.g. "what's Patrick's email?", "what X profiles did you get?"), call get-task-context FIRST to check if the data has already been enriched — the user may have triggered enrichments through the widget. Only call add-contact-data-points / add-company-data-points if get-task-context shows the enrichment hasn't been run yet. - Use get-task-context to poll until async results complete; if values are still in-progress, wait and retry rather than answering with missing values. - If get-task-context is not available, fall back to get-task. - When Clay Audiences is enabled for the workspace, each result may include `existsInAudiences` — whether that record already exists in the user's Audiences (their system of record) — and, for matches, `audienceEntityId` plus `audienceFields` (the existing record's current field values, keyed by display name). Use this to tell net-new prospects apart from records the user already has, and answer questions about a matched record's existing data directly from `audienceFields` without extra tool calls; company `audienceEntityId` values can be passed to ask-question-about-accounts for deeper analysis. When `existsInAudiences` is absent, membership is unknown — do NOT claim a record is or isn't in Audiences. ## Displaying Results This tool returns data only, and this client has no results widget. Present the results yourself, concisely — a compact list or table of the returned records with the fields the user cares about (e.g. name, title, company, LinkedIn URL). When the search reports `hasMore: true` and the user wants more, call `load-more-search-results` with the returned `taskId`. ## Enrichment This tool does NOT enrich (it takes no data points). To add custom research data points, call `add-contact-data-points` (for contacts) or `add-company-data-points` (for companies) with the returned `taskId` after this tool.
Inputs
contactIdentifiersarrayrequired
Array of contact identifiers to find and enrich, with their company identifiers
claymcp_find_and_enrich_companyFind and enrich a single company by domain or LinkedIn URL.Write
Find and Enrich Company
Find and enrich a single company by domain or LinkedIn URL. Use for prospecting publicly available company info (funding, competitors, tech stack, etc.). Returns a taskId for follow-up enrichment.
- Idempotent
Inputs
companyIdentifierstringrequired
Company identifier (domain like "clay.com" or LinkedIn URL like "https://www.linkedin.com/company/grow-with-clay")
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
companyDataPointsarray
Optional data points to enrich during search creation
claymcp_find_and_enrich_contacts_at_companySearch for contacts at a company by role, title, name, or department.Write
Find and Enrich Contacts at Company
Search for contacts at a company by role, title, name, or department. Supports filtering by job title keywords, locations, tenure, certifications, languages, and more. Returns a taskId for follow-up enrichment.
- Idempotent
Inputs
companyIdentifierstringrequired
The company identifier to search for company and contacts. Either a domain (e.g. "clay.com") or a LinkedIn URL (e.g. "https://www.linkedin.com/company/grow-with-clay").
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
contactFiltersobject
No description.
dataPointsobject
Optional data points to enrich during search creation
claymcp_find_and_enrich_list_of_contactsFind and enrich specific named contacts at their companies.Write
Find and Enrich List of Contacts
Find and enrich specific named contacts at their companies. Use when you have a list of specific people by name (e.g. "John Smith at OpenAI"). Returns a taskId for follow-up enrichment.
- Idempotent
Inputs
contactIdentifiersarrayrequired
Array of contact identifiers to find and enrich, with their company identifiers
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
dataPointsobject
Optional data points to enrich during search creation
claymcp_load_more_search_resultsFetch the next page (up to 20 more results) of an existing search.Write
Load More Search Results
Fetch the next page (up to 20 more results) of an existing search. ## When to Use Call this when the user wants MORE results than a `search-contacts` or `search-companies` call returned, and that search reported more were available (`hasMore: true`). Pass the `taskId` of the most recent page. Each page is a separate result set with its own `taskId`. Only `search-contacts` and `search-companies` paginate; calling this on a `search-contacts-by-name` task returns an error. ## Loading many results Fetch pages in sequence until you have as many results as the user asked for (or `hasMore` is false). Don't keep looping past what the request needs. ## Parameters - taskId (required): The taskId of the current page of results (mcp-task-* or legacy cgas-search-id-*). ## Response Returns the next page's results and a NEW `taskId`. Use that taskId to enrich or to load the page after it. `hasMore` indicates whether further pages remain.
Inputs
taskIdstringrequired
The taskId of the current page of results. Returns a new taskId for the next page (up to 20 more).
claymcp_track_eventTrack an analytics event with optional properties.Write
Track Event
Track an analytics event with optional properties.
Inputs
eventNamestringrequired
The name of the event to track
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
propertiesobject
Additional properties to include with the event
claymcp_run_subroutineExecute a custom function on contacts/companies from an existing search.Destructive
Run Subroutine
Execute a custom function on contacts/companies from an existing search. Use when you have a taskId from a previous search and want to run a subroutine on all or specific contacts. Requires fieldMapping to map entity fields to subroutine inputs.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
subroutine_idstringrequired
The ID of the subroutine to execute. Get this from list_subroutines.
taskIdstringrequired
Required. The taskId from the existing search task to add results to.
entityIdsarray
Optional. Array of entityIds to run on. When omitted with fieldMapping, runs on all contacts.
fieldMappingobject
Required for batch mode (running on ALL contacts). Format: { "entityField": "subroutineInput" } — the KEY is the entity field name (from contact data), the VALUE is the subroutine input name. Example: if entity has "name" and subroutine needs "full_name", use {"name": "full_name"}. Either provide entityIds OR fieldMapping, not both.
inputsobject
Optional. Literal input values applied to every entity, for an input the search data does not carry (e.g. {"Salesforce Campaign ID": "7018b00000ABCDEF"}, one campaign every contact is added to). Only for a value that is the same for every entity — a value that differs per entity (email, name, LinkedIn URL) belongs in fieldMapping, or every entity runs on one entity's value. Keys are subroutine input names from list_subroutines. An input passed here needs no fieldMapping entry. Ask the user for a value you do not have.
claymcp_run_subroutine_directExecute a custom function directly on one or more sets of provided inputs, without needing an existing task or entityIds.Destructive
Run Subroutine Direct
Execute a custom function directly on one or more sets of provided inputs, without needing an existing task or entityIds. Use when the user provides specific input values (LinkedIn URL, name, email, etc.) and wants to run a function on that data directly, for one value or many.
Inputs
inputsarrayrequired
Array of input objects, one per run (max 1000); use a single-element array to run once. Each object's keys must match the input names from list_subroutines. Example: [{"Linkedin URL": "https://linkedin.com/in/john"}, {"Linkedin URL": "https://linkedin.com/in/jane"}]
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
subroutine_idstringrequired
The ID of the subroutine to execute. Get this from list_subroutines.
claymcp_run_subroutine_no_mappingRun a custom subroutine on search entities.Destructive
Run Subroutine No Mapping
Run a custom subroutine on search entities. The backend automatically generates the field mapping. Requires a subroutine_id and taskId from an existing search.
Inputs
rationalestringrequired
Always provide a brief explanation of why you are calling this tool
subroutine_idstringrequired
The ID of the subroutine to execute.
taskIdstringrequired
The taskId from the existing search.
entityIdsarray
Optional. Array of entityIds to run on. When omitted, runs on all entities.
inputsobject
Optional. Explicit values for inputs the user selected (e.g. dropdown pickers), keyed by input name. Applied as-is; these override field mapping.

Setup

Install the SDK

Set your credentials

Create the Clay MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Add Company Data Points

Inputs

Add Contact Data Points

Inputs

Ask Question About Accounts

Inputs

Get Credits Available

Inputs

Get Current Workspace

Inputs

Get Subroutine Input Options

Inputs

Get Task

Inputs

Get Task Context

Inputs

List Subroutines

Inputs

Query Objects

Inputs

Search Companies

Inputs

Search Contacts

Inputs

Search Contacts By Name

Inputs

Find and Enrich Company

Inputs

Find and Enrich Contacts at Company

Inputs

Find and Enrich List of Contacts

Inputs

Load More Search Results

Inputs

Track Event

Inputs

Run Subroutine

Inputs

Run Subroutine Direct

Inputs

Run Subroutine No Mapping

Inputs

Related: other CRM & Sales connectors