# Clay MCP MCP Server

> **Clay MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Clay MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/clay-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Access Clay's prospecting and enrichment platform through AI assistants. Find and enrich contacts, research companies, generate personalized outreach, and run custom GTM workflows using data from 200+ providers.

---

## Details

- Server ID: `clay-mcp`
- Version: 1.0.0
- Tools: 17
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Clay MCP has to be in the toolset
first. In order:

1. Add Clay MCP to your toolset at https://mewcp.com/mcp/clay-mcp
2. Connect your Clay MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (17)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `find-and-enrich-contacts-at-company` _(read)_ — Search for contacts at a company by role, title, name, or department. ## Quick Reference - **This tool**: Find TYPES of people (e.g., "engineers at Stripe",…
- `find-and-enrich-list-of-contacts` _(read)_ — Find and enrich specific named contacts at their companies. ## Quick Reference - **This tool**: Find SPECIFIC named people (e.g., "John Smith at OpenAI", "Jane…
- `find-and-enrich-company` _(read)_ — Find and enrich a single company by domain or LinkedIn URL. ## Quick Reference - **This tool**: Prospect and research PUBLICLY AVAILABLE company info (e.g.,…
- `add-contact-data-points` _(write)_ — Add data points to contacts in an existing search. Supports enriching ALL contacts or specific contacts via entityIds. ## Quick Reference - **This tool**:…
- `add-company-data-points` _(write)_ — Add data points to companies in an existing search. Supports enriching ALL companies or specific companies via entityIds. ## Quick Reference - **This tool**:…
- `get-credits-available` _(read)_ — Check if credits are available for the workspace. Returns hasWorkspaceCredits, hasSalesRepCredits, (when credit budgets are enabled) hasBudgetCredits, and…
- `get-current-workspace` _(read)_ — Report which Clay workspace this connection is pinned to. Returns workspaceName, workspaceId, and workspaceUrl. Use when the user asks which workspace they are…
- `get-task` _(read)_ — Get 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…
- `get-task-context` _(read)_ — Retrieve 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…
- `track-event` _(read)_ — Track an analytics event with optional properties.
- `run_subroutine_no_mapping` _(write)_ — Run a custom subroutine on search entities. The backend automatically generates the field mapping.
- `get_subroutine_input_options` _(read)_ — Fetch the available dropdown options for a subroutine input that has a configured options source.
- `list_subroutines` _(read)_ — List available functions. Available functions: Company Address, Company Domain, Company Employee Count, Company Industry, Enrich Company, Company News, Company…
- `run_subroutine` _(write)_ — Execute a function on contacts/companies FROM AN EXISTING SEARCH (Company Address, Company Domain, Company Employee Count, Company Industry, Enrich Company,…
- `run_subroutine_direct` _(write)_ — Execute 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…
- `ask-question-about-accounts` _(read)_ — Ask a natural language question about one or more accounts available in Clay Audiences. Depending on your workspace settings and whether Salesforce owner data…
- `query-objects` _(read)_ — Query audience accounts, contacts, or deals using natural language. This tool translates your description into a structured filter, validates it against the…

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/clay-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/clay-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/clay-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/clay-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/clay-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/clay-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/clay-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/clay-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/clay-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/clay-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/clay-mcp/connect/dsh
- Python: https://mewcp.com/mcp/clay-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/clay-mcp/connect/typescript