Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Clay API

Give your agents access to Clay API. Bring your own Clay key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Clay

Instant

Clay is a go-to-market data enrichment and workflow automation platform for searching people and companies, running routines, and querying workspace tables. It helps teams enrich leads, automate GTM workflows, and keep workspace data synchronized.

15 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Clay without a separate account or API key for each one. New accounts start with $2 of free credit.

No Clay account or key

Your agent calls Clay through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.074 per requested result (1–50); charged for the full limit., paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Clay with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Clay API to your AI assistant

Use Clay from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use Clay through Composio Instant to search for companies with the domain microsoft.com. Return the matching company record.

What success looks like

CLAY_SEARCH_PEOPLE_OR_COMPANIES

Your assistant runs Clay and replies with the matching company record for microsoft.com.

Runs on Composio Instant

SDK

Use the Clay API in your code

Call Clay from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
CLAY_SEARCH_PEOPLE_OR_COMPANIES
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["clay"],
    instant={
        "toolkits": {"enable": ["clay"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "CLAY_SEARCH_PEOPLE_OR_COMPANIES",
    arguments={
        "limit": 1,
        "query": "companies with the domain microsoft.com",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["clay"],
  instant: {
    toolkits: { enable: ["clay"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "CLAY_SEARCH_PEOPLE_OR_COMPANIES",
  {
    "limit": 1,
    "query": "companies with the domain microsoft.com"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": [
    "<company result>"
  ],
  "error": null,
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Clay API tools

3 Clay tools run on Instant, priced per call with no Clay key. Tools marked Your key need your own Clay account.

Action	Tool slug	What it does	Availability
Search People or Companies	CLAY_SEARCH_PEOPLE_OR_COMPANIES	Search Clay for people or companies and return the first page of results.	Instant$0.074 per requested result (1–50); charged for the full limit.
Continue Search	CLAY_CONTINUE_SEARCH	Consume one next page from an existing Clay query-mode search.	Instant$0.074 per requested result (1–50); charged for the full limit.
Get Search Query Reference	CLAY_GET_SEARCH_QUERY_REFERENCE	Return Clay's current advanced-search field and grammar reference for composing people or company queries.	Instant$0 per reference lookup
Run Routine	CLAY_RUN_ROUTINE	Run a Clay routine on 1 to 100 items and return results or run progress.	Your key
Query Table Rows	CLAY_QUERY_TABLE_ROWS	Query Clay workspace tables and return a page of rows.	Your key
Start Routine Batch	CLAY_START_ROUTINE_BATCH	Start an asynchronous routine batch from an uploaded JSONL file.	Your key
Get Routine Results	CLAY_GET_ROUTINE_RUN_RESULTS	Check progress or retrieve a page of results from an inline routine run.	Your key

Instant prices are Clay's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Clay API use cases and example prompts

Copy a prompt into your agent. Each one uses Clay with apps you connect through Composio.

Build a payroll prospect list
Use Clay to search for B2B payroll software companies that serve small businesses. Add the companies from the first page of results, with the details Clay returns, to my Payroll Prospects sheet in Google Sheets. Post the number of rows added in Slack's #sales channel.
Apps used: Clay, Google Sheets, Slack
Add new accounts to HubSpot
Use Clay to search for companies that sell customer support software to ecommerce businesses. Compare the companies from the first page of results with my target account list in HubSpot, and add any new matches. Draft a Gmail message to my sales team listing the companies you added.
Apps used: Clay, HubSpot, Gmail
Create a market landscape page
Use Clay to search for cybersecurity software companies that serve mid-sized businesses. Create a page called Mid-Market Security Landscape in my Sales Playbook in Notion, and add the companies from the first page of results with the details Clay returns.
Apps used: Clay, Notion
Track data observability vendors
Use Clay to search for companies that sell data observability software. Add the companies from the first page of results and the details Clay returns to a market brief in Google Docs. Post an update in Slack's #product channel with the brief title and the number of companies listed.
Apps used: Clay, Google Docs, Slack

TROUBLESHOOTING

Clay API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Connect your own Clay key to use CLAY_GET_ROUTINE_RUN_RESULTS.

Connect your own Clay key to use CLAY_QUERY_TABLE_ROWS.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Clay account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Apollo

Api Key

Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Start with Clay.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Clay tool your agent needs.Free to start.

Start building

Clay API

What is Composio Instant?

No Clay account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Clay API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Clay API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Clay API tools

Clay API use cases and example prompts

Build a payroll prospect list

Add new accounts to HubSpot

Create a market landscape page

Track data observability vendors

Clay API troubleshooting

Routine run returns an in-progress state without results

Table query returns only one page of rows

An action asks you to connect Clay

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Apollo

Firecrawl

Tavily

Exa

Start with Clay.It takes 30 seconds.