PlugWiki

Clay MCP, Clay's hosted MCP server

OfficialRemote
Gethttps://api.clay.com/v3/mcpDocs
Tools
7
7 read · 0 change
Works in
4
supported apps
Risk
Medium
read only
Auth
OAuth
sign in, no key

Lets Claude, ChatGPT or Codex find and enrich contacts and companies with Clay, research accounts and run your team's Clay Functions. Uses Clay credits.

This is Clay's own connection for AI assistants, and Clay runs it for you. You can ask your assistant to find people at a company, enrich them with verified emails and phone numbers, research an account and draft outreach, or run a workflow your ops team built. Every search and enrichment spends Clay credits, and one question can trigger several charged steps, so set a credit limit before reps start. Clay says it suits work on 1 to 20 contacts; bigger lists belong in a Clay table.

Good for

  • Sales reps who research accounts and find contacts without opening Clay
  • RevOps teams who build Clay Functions once and let every rep run them from chat
  • Founders and marketers who need verified emails for a short list of people
  • Clay admins who want rep access with credit limits and no access to tables

Works in

4 supported · 10 should work

Tap an app to see how to set it up and any known problems.

Install Clay MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Clay MCP server to Claude Code. Run this command:

claude mcp add --transport http clay https://api.clay.com/v3/mcp

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Sign in with your Clay account.

Read-only mode: There's no read-only mode. Ask your Clay admin for a monthly credit limit so a long session can't spend more than you expect.

Clay says it works in Claude Code, where results come back as text instead of the interactive table. Clay does not publish a command, so this one is generated from the server address. Run /mcp in a session to sign in. Each search and enrichment spends Clay credits; new accounts get 500 free on first connect. Your Clay admin must allow this app under Allowed MCP clients, or sign-in is refused.

Built from the package data we hold. Not yet tested by us.

Tools

  • Finds people at a company by title, seniority or location, with contact details

    Searches for people at one company who match the roles you describe, and can add details such as verified emails and work history. Spends Clay credits.

    Try: “Find VP- and Director-level RevOps leaders at rippling.com who started in the last 9 months.”

    Network · find-and-enrich-contacts-at-company

  • Researches a company: hiring, tech stack, funding and leadership changes

    Looks up a company and gathers information such as headcount, hiring trends, tech stack, funding and recent leadership changes. Spends Clay credits.

    Try: “What are stripe.com's top go-to-market priorities this year? Any recent executive changes?”

    Network · find-and-enrich-company

  • Looks up and enriches a list of people you give it

    Takes a list of people and finds more about each one, such as verified emails, phone numbers and work history. Spends Clay credits.

    Try: “Enrich these five people with work emails and their current titles.”

    Network · find-and-enrich-list-of-contacts

  • Adds more details to people already found, such as email or work history

    Adds extra data points to contacts from an earlier search, for example an email address, a work history summary or thought leadership. Spends Clay credits.

    Try: “Add work emails and a work history summary for these contacts.”

    Network · add-contact-data-points

  • Adds more details to companies already found

    Adds extra data points to companies from an earlier search, such as tech stack or funding. Spends Clay credits.

    Try: “Add funding and tech stack for the companies in that list.”

    Network · add-company-data-points

  • Shows how many Clay credits you have left

    Checks the credits available to you, including any monthly limit your admin set.

    Try: “How many Clay credits do I have left this month?”

    Read · get-credits-available

  • Used by the assistant behind the scenes

    Reopens results from an earlier search

    Fetches the results of a search already run, for example to load the next page of results.

    Try: “Show me the next 20 people from that search.”

    Read · get-existing-search

From the official docs

Pros and cons

Good

  • Built and run by Clay, with nothing to install
  • Sign in with your Clay account; new accounts get 500 free credits
  • Same credit rates as inside Clay, with no extra charge for using it from chat
  • Admins set monthly credit limits per rep and pick which Functions reps can run
  • Reps can get MCP-only access with no view of tables, API keys or workflows
  • Documented for Claude, Claude Code, ChatGPT, Codex, Copilot and Glean

Watch out

  • Every search and enrichment spends credits, and one prompt can run several
  • Results stop at 100 per search; larger lists need a Clay table
  • No read-only mode
  • Claude Enterprise needs an admin to add the connector first
  • Admins cannot revoke one rep's connection without removing them or zeroing their limit

Permissions

medium risk · 5 things to watch

Medium risk

The main risk is cost: your assistant decides which Clay lookups to run, and each one spends credits from your workspace. Set a default monthly credit limit for reps before they connect, and give reps the Sales Rep role so they cannot reach your tables.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • One question can spend credits several times

    The assistant picks which Clay tools to run, so one prompt may search, enrich and run a Function, each charged. Set a monthly credit limit before reps connect. university.clay.com

  • Admins can't cut off one connection

    To stop a rep, remove them from the workspace or set their credit limit to 0. university.clay.com

  • Contact details land in your AI chat

    Verified emails, phone numbers and work history are returned into the conversation, so your AI app's data terms apply to them. university.clay.com

  • Unknown apps show as unverified

    Apps that register themselves appear as an Unverified application on Clay's sign-in screen. Check where it sends you before approving. university.clay.com

  • Admins choose which AI apps may connect

    Switching an app off under Allowed MCP clients also blocks its next token refresh, so existing connections stop too. university.clay.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only mode. Admins cap spend with a default or per-rep monthly credit limit (0 blocks all actions), choose which Functions are enabled for MCP, and pick allowed clients under Allowed MCP clients.
Talks toapi.clay.com
Sign-in and keysOAuth tokens held by your AI client; access tokens last one hour and refresh tokens rotate
Scopes

  • OAuth scope mcp, limited to the Clay workspace you pick on the consent screen

  • Runs Clay's built-in search and enrichment tools and any Functions an admin enabled for MCP

Alternatives

Use Clay's hosted connector to research accounts and find contacts from chat. clay-gtm-cli is a community tool for GTM engineers who automate Clay tables, and Apollo's server fits teams whose data lives in Apollo.

ServerOfficialRunsSign-inToolsBest for
For Clay
Clay (hosted)This pageOfficialHostedAccount7Rep prospecting
Other tools for the same job
clay-gtm-cliCommunityLocal––Table webhooks
Apollo.ioFor Apollo.ioOfficialHostedAccount–Apollo users

Questions

Is Clay MCP free?

Partly. You get 500 free Clay credits the first time you connect. After that, every search and enrichment uses your plan's credits at the same rates as inside Clay, with no extra charge for using it from chat.

What is the Clay MCP server URL?

https://api.clay.com/v3/mcp. You sign in with your Clay account and pick a workspace.

Do I need a Clay account?

You need one, but you don't have to create it first. If you are new to Clay, an account is created for you when you connect from Claude.

How many contacts can I pull at once?

Results come in pages of 20, up to 100 per search. Clay suggests the chat for 1 to 20 contacts and a Clay table for bigger lists.

How do admins stop reps from burning credits?

Set a default monthly credit limit on the MCP page in Clay, then override it per rep if needed. A limit of 0 blocks further actions until the 1st of the next month.

Is it safe to connect Clay to my AI assistant?

It can only reach the workspace you pick, and reps with the Sales Rep role cannot see your tables or API keys. The contact data it finds is returned into your chat, so your AI app's data terms apply to it.

Why doesn't Clay show up in Claude Enterprise?

On Claude Enterprise, an admin has to add the Clay connector before members can use it.

Why do I get access denied when it worked before?

Your Clay admin has turned off your AI app under Allowed MCP clients. Clay checks this every time your login renews, so existing connections stop too.

Can reps run our own Clay workflows?

Yes. An admin enables a Clay Function for MCP and gives it a clear name, and reps run it by asking for it by name. Ask "What functions do you have?" to see the list.

How do I add Clay to Claude?

Open Clay on Claude's connectors page, connect and sign in to Clay. For ChatGPT, type @Clay in a chat; for other apps, use the install box above.

Examples

  • Find recently hired leaders at a target account

    Find VP- and Director-level RevOps leaders at [Company] who started in the last 9 months.

    Source

  • Research an account before outreach

    What are [Company]'s top go-to-market priorities this year? Any recent executive changes or expansion signals?

    Source

  • Build a list of target companies

    Find B2B SaaS companies in New York with 200–500 employees.

    Source

  • Draft an email from the research

    Write an email referencing [Company]'s recent product launches and their VP of Engineering's comments on developer productivity, under 130 words.

    Source

  • Run a workflow RevOps built

    Run Clay outbound generator for sarah@acme.com

    Source

Information

updated Nov 1, 2026

Publisher
Official
Endpoint
https://api.clay.com/v3/mcp
Transport
Streamable HTTP
Auth
OAuth

WebsiteDocsOfficial listing

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 6
  1. Using Clay in ChatGPT · university.clay.com
  2. Using Clay in Claude · university.clay.com
  3. Connect your platform to Clay MCP · university.clay.com
  4. MCP in Clay · university.clay.com
  5. What Is Clay MCP? · clay.com
  6. Clay connector for Claude · claude.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 1, 2026.