# Clay tools in Cogny 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. - **Read** (7): only reads data. - **Write** (1): creates or changes something. - **Destructive** (0): deletes, 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. ## 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. ## All tools | Tool | Kind | What it does | |---|---|---| | `get_account` | Read | See which Clay user and workspace the connected API key belongs to — the connection check. | | `get_credit_balance` | Read | See how many Clay credits your workspace has left, and the key owner's monthly credit limit. | | `query_table` | Read | Read rows from one of your Clay tables, with column selection, filters, sorting, grouping and joins. | | `get_search_query_reference` | Read | Get the fields and grammar for searching Clay's people and company database, to write a search query. | | `search_clay_database` | Read | Find people or companies in Clay's GTM database that match a Clay search query, and return the first page. | | `get_more_search_results` | Read | Get the next page of people or companies from an earlier Clay database search. | | `get_routine_run_results` | Read | Check a Clay routine run's progress and read its results per item. | | `start_routine_run` | Write | Run 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`. --- All integrations: https://cogny.com/integrations/tools/index.md Plans, approvals, limits and data protection: https://cogny.com/buying-guide.md What Cogny is: https://cogny.com/llms.txt