MCP Server

Enrichment inside your AI tools

Connect the SalesQL MCP to Claude, ChatGPT, Gemini or Cursor and reveal verified emails, enrich companies and check credits — without leaving the chat.

Endpointhttps://mcp.salesql.com/mcp

TransportStreamable HTTP

AuthAuthorization: Bearer <API_KEY>

Works in

Prompt library

Copy a playbook, or open it straight in your assistant. Connect the MCP in that client first.

Enrich & write

"Enrich linkedin.com/in/jane-doe and draft a short intro email in my voice."

Find a dial

"Find the direct dial and verified email for Acme's VP of Marketing."

Bulk list

"Enrich these 40 LinkedIn URLs with verified emails and export as CSV."

Company intel

"Enrich acme.com — give me size, industry and the key decision-makers."

Reverse email

"Who is behind jane.doe@acme.com? Give me their full name, title, company and LinkedIn."

Credits

"How many enrichment credits do I have left this month, and when do they refresh?"

Connect your client

Every client points at the same endpoint — just replace YOUR_API_KEY with a key from your dashboard. Jump to yours:

Claude Desktop

The easiest path if you live in the Claude app. Open Settings → Developer → Edit config, paste the block below and restart Claude — the SalesQL tools show up in the composer.

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "salesql": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.salesql.com/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Bridges the HTTP server with mcp-remote until the native connector ships.

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Claude Desktop

Help me connect the SalesQL MCP server to Claude Desktop. Config location: Claude Desktop · claude_desktop_config.json. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Claude Code

One command in your terminal — the fastest route for developers and vibe coders. Run it once, then type /mcp to confirm salesql shows as connected.

Claude Code · terminal

claude mcp add --transport http salesql \
  https://mcp.salesql.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Claude Code

Help me connect the SalesQL MCP server to Claude Code. Config location: Claude Code · terminal. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

ChatGPT

Developer Mode

Add SalesQL as a custom connector: Settings → Connectors → Create, then paste the endpoint and your key.

ChatGPT · connector

# Developer Mode → Settings → Connectors → Create
Name:  SalesQL
URL:   https://mcp.salesql.com/mcp
Auth:  Bearer YOUR_API_KEY

Custom connectors require ChatGPT Developer Mode (Plus / Pro / Business / Enterprise).

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · ChatGPT

Help me connect the SalesQL MCP server to ChatGPT. Config location: ChatGPT · connector. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Gemini CLI

Gemini CLI · ~/.gemini/settings.json

{
  "mcpServers": {
    "salesql": {
      "httpUrl": "https://mcp.salesql.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Gemini CLI

Help me connect the SalesQL MCP server to Gemini CLI. Config location: Gemini CLI · ~/.gemini/settings.json. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Perplexity

Connectors

Add SalesQL as a custom connector: Settings → Connectors → Add connector, then paste the endpoint and your key. Local MCP works in the Mac app today; remote connectors are rolling out.

Perplexity · connector

# Settings → Connectors → Add connector
Name:  SalesQL
URL:   https://mcp.salesql.com/mcp
Auth:  Bearer YOUR_API_KEY

Custom MCP connectors are available on the Perplexity Mac app (local) with remote support rolling out.

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Perplexity

Help me connect the SalesQL MCP server to Perplexity. Config location: Perplexity · connector. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

VS Code

For GitHub Copilot agent mode. Commit .vscode/mcp.json to share the server with your whole team.

VS Code · .vscode/mcp.json

{
  "servers": {
    "salesql": {
      "type": "http",
      "url": "https://mcp.salesql.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · VS Code

Help me connect the SalesQL MCP server to VS Code. Config location: VS Code · .vscode/mcp.json. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Cursor

Add it globally in ~/.cursor/mcp.json (or per project) — the agent calls the tools whenever a task needs contact data.

Cursor · ~/.cursor/mcp.json

{
  "mcpServers": {
    "salesql": {
      "url": "https://mcp.salesql.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Cursor

Help me connect the SalesQL MCP server to Cursor. Config location: Cursor · ~/.cursor/mcp.json. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Any client

Any MCP client that speaks Streamable HTTP works — point it at the endpoint with your Bearer key.

Any MCP client · Streamable HTTP

Endpoint:  https://mcp.salesql.com/mcp
Header:    Authorization: Bearer YOUR_API_KEY

Tell your agent to help you set up this config

Paste this into any assistant and it will do the setup with you.

Setup prompt · Any client

Help me connect the SalesQL MCP server to Any client. Config location: Any MCP client · Streamable HTTP. Endpoint: https://mcp.salesql.com/mcp (Streamable HTTP), auth header "Authorization: Bearer <API_KEY>". Write the exact config for me keeping a YOUR_API_KEY placeholder, tell me where to save it and how to apply or restart, and then remind me to replace the placeholder with my key from https://app.salesql.com/dashboard/enrichment/api — I won't paste my key in this chat.

Available tools

Enrichment consumes credits; lookup and get_account_status are free.

Tool	What it does	Cost
`enrich_person`	Reveal a contact’s work email, phone, job title, company and LinkedIn. Prefer a LinkedIn URL; otherwise name + company.	1 credit
`enrich_person_bulk`	Enrich up to 100 people in a single request. Each item takes a LinkedIn URL, an email, or a name + organization.	1 credit
`enrich_organization`	Enrich a company: domain, industry, size, location, logo and LinkedIn. Prefer a LinkedIn URL, then a domain, then a name.	1 credit
`enrich_organization_bulk`	Enrich up to 100 companies in a single request. Each item takes a LinkedIn URL, a domain, or a name.	1 credit
`get_account_status`	Return the current plan, available credits, next refresh date, role and rate limits for the authenticated key.	Free
`lookup`	Resolve the exact filter values (seniority, company_size, company_type, industry, country, region) to use in future search calls.	Free

Key scopes

MCP keys carry scopes that gate what they can do — each scope grants specific actions. Today's keys grant full access; granular scopes ship with MCP keys.

accountreadAccount usage, plan and credit balance (get_account_status). Live

enrichenrichReveal and enrich people & organizations, single and bulk. Live

searchreadProspector — search people & companies (includes filter lookups). Soon

verifyverifyEmail verification. Soon

campaignsreadwritesendCreate and manage outbound campaigns. Later

Rate limits & credits

Unified API & MCP quota · shared

The MCP and REST API draw on one shared credit balance and rate limit — across all your API keys, MCP keys and connected clients, based on your plan. Bursts above your plan’s per-minute limit return 429 — back off and retry.

Enrichment spends 1 credit per matched contact; free tools (get_account_status, lookup) don’t. Check your live balance, plan and limits any time with get_account_status.

Troubleshooting

The client can’t connect: Confirm the transport is HTTP (Streamable HTTP) and the URL ends in /mcp. Most failures are a missing or mistyped Bearer key — restart the client after editing its config.
Tools return “insufficient credits”: Check get_account_status. Enrichment needs credits; top up in your dashboard. get_account_status and lookup are always free.
Enrichment returns no match: Unmatched lookups don’t spend credits. Try a LinkedIn URL — it’s the most reliable identifier — and drop match_if_direct_email / match_if_direct_phone if you set them.