Start free
    Menu
    How it worksIntegrationsCustomersPricingSign in

    integrations tools clay

    Clay MCP for your AI agent

    Cogny's Clay integration exposes 8 tools (7 read, 1 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

    • 7readonly reads data.
    • 1writecreates or changes something.
    • 0destructivedeletes, removes or replaces something.

    Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect Clay in Cogny. Every Clay tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    Notes

    Clay connects with one value: a personal API key from API and CLI → API keys in Clay. The key acts as the Clay user who created it, in that user's workspace, so connect it as a user who can see the tables and functions Cogny should work with. If that user leaves the workspace, the key stops working and the connection asks to be reconnected.

    Tables are read with query_table, which Clay offers on Enterprise plans only. On other plans the call answers that the plan doesn't allow it. Clay's API has no way to list tables or workbooks, so give the agent the table's Clay URL (or the t_… id after /tables/). A query selects up to 20 columns, filters, sorts, groups and aggregates, and joins up to five tables; pages hold up to 100 rows.

    Database searches (search_clay_database) find people or companies in Clay's own GTM database with a Clay search query. Results count against the workspace's Clay search result quota (Free: 100 per 30 days, 50 per search; paid plans much more), and each response shows what is left.

    Enrichment runs (start_routine_run) run a Clay-managed or custom function on 1–100 items and spend the workspace's Clay credits. They stay ask-first until you allow them in Settings. Check get_credit_balance first, then read the results with get_routine_run_results.

    Clay rate-limits per workspace; a limited call says how many seconds to wait.

    Known gaps

    • Rows can't be added, updated or deleted: Clay's API has no write endpoint for table rows. Sending rows into a table through a table's own webhook source isn't offered.
    • Tables and workbooks can't be listed; a table must be named by its URL or id.
    • Table reads need a Clay Enterprise plan.
    • Batch enrichment runs over more than 100 items (Clay's file-upload batch API) aren't exposed; split the list into runs of 100.
    • Columns, enrichments and workbooks can't be created or edited, and a table's own enrichment columns can't be re-run.
    • Clay's workflow-run search (beta), Audiences and Signals aren't exposed.

    what each tool does.

    Read 7 · only reads data

    • get_accountReadSee which Clay user and workspace the connected API key belongs to — the connection check.
    • get_credit_balanceReadSee how many Clay credits your workspace has left, and the key owner's monthly credit limit.
    • query_tableReadRead rows from one of your Clay tables, with column selection, filters, sorting, grouping and joins.
    • get_search_query_referenceReadGet the fields and grammar for searching Clay's people and company database, to write a search query.
    • search_clay_databaseReadFind people or companies in Clay's GTM database that match a Clay search query, and return the first page.
    • get_more_search_resultsReadGet the next page of people or companies from an earlier Clay database search.
    • get_routine_run_resultsReadCheck a Clay routine run's progress and read its results per item.

    Write 1 · creates or changes something

    • start_routine_runWriteRun a Clay enrichment function on up to 100 leads or accounts, such as finding work emails or company data.

    Exact input schemas come from tools/list once Clay is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.

    This page as markdownAll integrations