Clay MCP for AI agents
Agents read Clay MCP at once. Changes and sends are held for a person's approval by default.
About Clay MCP
Clay MCP lets agents research companies and contacts, run enrichment providers and Clay functions, and return enriched prospect data for authorized workspaces.
What an agent can do in Clay MCP
Every Clay MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Clay MCP without asking first. 9 actions.
- Ask-question-about-accountsAsk a natural language question about one or more accounts available in Clay Audiences. Depending on your workspace settings and whether Salesforce owner data is available, this may be limited to acco
- Get-credits-availableCheck if credits are available for the workspace. Returns hasWorkspaceCredits, hasSalesRepCredits, and (when credit budgets are enabled) hasBudgetCredits.
- Get-current-workspaceReport 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 search
- Get subroutine input optionsFetch the available dropdown options for a subroutine input that has a configured options source.
- Get-taskGet task status and results by task ID. This tool handles all task types (search, direct) and returns the current state. ## When to Use This Tool This is a private tool used by the widget for polling
- Get-task-contextRetrieve the current state of a task — all entities, enrichment values, and statuses. ## When to Use Call this when you need the actual data behind an entity to answer the user's question — e.g. the u
- List subroutinesList available functions. Available functions: Company Address, Company Industry, Company Employee Count, Company Domain, Company Job Openings, Company Revenue (Exact), Company Latest Funding, Enrich
- Query-objectsQuery audience accounts, contacts, or deals using natural language. This tool translates your description into a structured filter, validates it against the database, and returns matching entities wit
- Track-eventTrack an analytics event with optional properties.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 5 actions.
- Add-company-data-pointsAdd data points to companies in an existing search. Supports enriching ALL companies or specific companies via entityIds. ## Quick Reference - **This tool**: Enrich COMPANIES with funding, tech stack,
- Add-contact-data-pointsAdd data points to contacts in an existing search. Supports enriching ALL contacts or specific contacts via entityIds. ## Quick Reference - **This tool**: Enrich CONTACTS with emails, work history, et
- Run subroutineExecute a function on contacts/companies FROM AN EXISTING SEARCH (Company Address, Company Industry, Company Employee Count, Company Domain, Company Job Openings, Company Revenue (Exact), Company Late
- Run subroutine directExecute a custom function on one or more sets of provided inputs. NO existing task or entityIds needed. ## When to Use This Tool Use this tool when the user provides specific input values (like a Link
- Run subroutine no mappingRun a custom subroutine on search entities. The backend automatically generates the field mapping.
Changes wait in Needs you
Changes and sends in Clay MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Clay MCP questions
Can an agent change data in Clay MCP on its own?
Not by default. Changes and sends in Clay MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Clay MCP?
This connector lists 9 read actions. Reads run at once, without waiting for approval.
How does Clay MCP connect?
It connects with dcr oauth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.