MCP setup

10ex ships a Model Context Protocol server. Once an AI agent can talk to it, the agent can perform any platform action you can: sign up, connect Gmail, ingest brand knowledge, import leads, preview and approve email sequences, launch ads, generate blogs, schedule webinars.

Two transports are supported:

• Streamable HTTP at https://api.10ex.ai/mcp. Recommended for production. Stateless, JSON-response mode.
• stdio for local Claude Desktop or Cursor when you want the agent on your laptop.

Authentication

Either credential works on either transport:

• Bearer JWT: your normal user JWT, best for local dev.
• First-party API key: format tnx_<prefix>_<secret>. Mint from Settings → API Keys in the product (admin-only in v1).

Header:

Authorization: Bearer tnx_abc12345_<secret>

How to connect Claude Desktop (stdio)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tenex": {
      "command": "uvx",
      "args": ["10ex-mcp"],
      "env": {
        "TENEX_API_KEY": "tnx_abc12345_<secret>",
        "TENEX_API_BASE": "https://api.10ex.ai"
      }
    }
  }
}

Restart Claude Desktop. You should see all 30+ 10ex tools listed in the tool drawer. If they’re missing, check the Claude Desktop log for an mcp startup error. Most failures are a missing uvx binary on your $PATH.

How to connect Cursor (stdio)

Add .cursor/mcp.json in your project (or set it globally):

{
  "mcpServers": {
    "tenex": {
      "command": "uvx",
      "args": ["10ex-mcp"],
      "env": {
        "TENEX_API_KEY": "tnx_abc12345_<secret>"
      }
    }
  }
}

Streamable HTTP (production)

Most agents (Claude with web tools, custom MCP clients, n8n, etc.) consume Streamable HTTP directly:

POST https://api.10ex.ai/mcp
Authorization: Bearer tnx_abc12345_<secret>
Content-Type: application/json

Smoke test

mcp-inspector --url https://api.10ex.ai/mcp \
  --header "Authorization: Bearer tnx_abc12345_<secret>"

You should see the full tool list. Try:

search_docs("how do I create a lead?")
list_agents_in_store()

What an agent can do

The agent will run signup, start_connector_oauth({ provider: "gmail" }), ingest_url_into_knowledge, bulk_import_leads, and launch_email_sequence in order, pausing at the OAuth step for you to click through.

Common mistakes

• Using the wrong env-var name. The package reads TENEX_API_KEY, not TEN_EX_API_KEY or API_KEY.
• Pointing at https://10ex.ai/mcp instead of https://api.10ex.ai/mcp. The marketing host doesn’t serve the MCP endpoint.
• Forgetting to restart Claude Desktop after editing the config. The server only loads on startup.

Full tool catalog: MCP tools reference.