Search for leads, reveal verified emails, enrich companies, and check your credit balance without leaving Claude, ChatGPT, Gemini, or Cursor. Your assistant does the lookup for you — no new tabs, no copy-pasting.
This article covers what the MCP does and how to connect. For endpoints, per-client configs, and technical troubleshooting, see the MCP documentation.
| Plan required | Any plan, including Free — limits vary by plan |
| Setup | One-click authorization (OAuth) — or an MCP key if your client can’t do OAuth |
| Works with | Claude, Claude Code, ChatGPT, Codex, Gemini CLI, Cursor, Perplexity, VS Code, and any Streamable HTTP client |
| Full technical docs | salesql.com/docs/mcp |
What it exposes
Once connected, your assistant can:
- Search for leads — find people and companies by job title, location, industry, company size, and more — the same data as Prospector
- Enrich a person — work email, phone, job title, LinkedIn (phone numbers aren’t included on the Free plan)
- Enrich a company — industry, size, location, LinkedIn
- Bulk enrich — up to 100 people or companies in one pass (10 on the Free plan)
- Verify emails — check whether an address exists and accepts mail, one at a time or in bulk
- Check credits — balance, next refresh date, plan, and rate limits
- Resolve filters — exact values before a search
Same account, same credit balance as the extension, dashboard, and API.
Requirements
- A SalesQL account on any plan — Free included
- An MCP-compatible client: Claude (web, desktop or mobile), Claude Code, ChatGPT (on the web), Codex, Gemini CLI, Cursor, Perplexity (Pro plan or above), VS Code, or any client that speaks Streamable HTTP
Connect now
Server URL: https://mcp.salesql.com/mcp
Option 1 — One-click authorization (recommended). Similar to connecting Zapier: click Connect, sign in to SalesQL, choose the permissions to grant, and approve access. No API key to copy.
- Connect via Claude — Customize → Connectors → + Add → Add custom connector. Name it SalesQL, paste the server URL, click Add, then Connect.
- Connect via ChatGPT (web) — Open the official SalesQL plugin (or search for SalesQL under Plugins in the ChatGPT sidebar) and click Install plugin (and Connect, if prompted). Sign in to SalesQL and approve access — no server URL needed.
Prefer to add it manually? Plugins → Add → Add custom MCP server. Name it SalesQL, paste the server URL, set Authentication to OAuth, then click Create as a plugin and Connect SalesQL. Don’t see Plugins yet? Use Developer Mode instead — steps in the MCP documentation. - Connect via Claude Code / Codex / Cursor / VS Code / Gemini CLI / Perplexity / any MCP client — exact steps in the MCP documentation
Option 2 — MCP key (advanced). Use this if your client can’t do OAuth, or if you’d rather use a long-lived key (for example, on a machine without a browser). Get your MCP key from your SalesQL dashboard and send it as a header: Authorization: Bearer YOUR_MCP_KEY. Per-client configs are in the MCP documentation.
Manage your connections. Every OAuth connection is listed in your SalesQL dashboard under Connectors → MCP → Connected clients, with the permissions it was granted. Disconnecting one revokes it immediately, and your other connected tools keep working.
Example prompts
- “Find 20 Heads of Marketing at e-commerce companies in London.”
- “Enrich linkedin.com/in/jane-doe and draft a short intro email in my voice.”
- “Find the direct dial and verified email for Acme’s VP of Marketing.”
- “Enrich these 40 LinkedIn URLs with verified emails and export as CSV.”
- “Verify these 50 emails before I send my campaign.”
- “Give me the size, industry, and key decision-makers at acme.com.”
- “Who is behind jane.doe@acme.com? Give me their full name, title, company and LinkedIn.”
- “How many enrichment credits do I have left this month, and when do they refresh?”
Credits and limits
Person enrichment costs 1 enrichment credit per matched contact — no match, no charge. Email verification costs 1 verification credit per address, from a balance separate from your enrichment credits. Searching people and companies, company enrichment, lookup, and get_account_status are always free. Search results show contact details masked until you enrich, so you can search and size a list before spending anything.
Daily and per-minute limits depend on your plan and are shared across all your connected AI tools, keys, and API usage. Over your plan’s per-minute limit? You’ll get a 429 — back off and retry.
| Free | Basic | |
|---|---|---|
| People search | 25/day · 10/min, shared with company search | 3,000/day · 100/min |
| Company search | Shared with people search | 1,000/day · 100/min |
| Enrich people | 25/day · 10/min | 600/day · 50/min |
| Enrich companies | 25/day · 10/min | 600/day · 50/min |
| Resolve filters (lookup) | 100/day · 20/min | 600/day · 50/min |
| Verify emails | 100/day · 10/min | 600/day · 50/min |
| Check bulk verification jobs | 300/day · 20/min | 600/day · 50/min |
| People or companies per bulk enrichment | 10 | 100 |
| Addresses per bulk verification | 100 | 500 |
| Search results per page | 25 | 100 |
| Results you can page through per search | 100 | 10,000 |
| Phone numbers in enrichment | No | Yes |
| Enrichment credits | 50/month | 2,000/month or 24,000/year |
| Email verifier credits per month | 100 | 5,000 |
On Professional and Premium, limits are the same for monthly and annual billing:
| Professional | Premium | |
|---|---|---|
| People search | 3,000/day · 100/min | 3,000/day · 100/min |
| Company search | 1,000/day · 100/min | 1,000/day · 100/min |
| Enrich people | 5,000/day · 180/min | 20,000/day · 300/min |
| Enrich companies | 5,000/day · 180/min | 20,000/day · 300/min |
| Resolve filters (lookup) | 600/day · 50/min | 600/day · 50/min |
| Verify emails | 600/day · 50/min | 600/day · 50/min |
| Check bulk verification jobs | 600/day · 50/min | 600/day · 50/min |
| People or companies per bulk enrichment | 100 | 100 |
| Addresses per bulk verification | 500 | 500 |
| Search results per page | 100 | 100 |
| Results you can page through per search | 10,000 | 10,000 |
| Phone numbers in enrichment | Yes | Yes |
| Enrichment credits | 5,000/month or 60,000/year | 12,000/month or 144,000/year |
| Email verifier credits per month | 10,000 | 20,000 |
Want to confirm your plan’s exact limits? Ask your assistant to run get_account_status.
What’s live, and what’s next
- account (read) — Live
- enrich (single + bulk) — Live
- search (Prospector) — Live
- verify — Live
- campaigns — Later
Troubleshooting
Seeing the wrong plan or credits? The connection uses whichever SalesQL account your browser was signed into when you approved it. Ask your assistant which SalesQL account and plan are connected. If it’s the wrong one, disconnect it under Connectors → MCP → Connected clients and reconnect while signed into the right account.
Can’t connect? Check that the server URL is exactly https://mcp.salesql.com/mcp and that your client uses Streamable HTTP. Opening the URL in a browser isn’t a valid test. In a company workspace (Claude Team or Enterprise, ChatGPT Business or Enterprise), an admin may need to add or allow the connector first.
“This MCP key lacks a required scope”? The connection was approved without that permission. Disconnect it under Connectors → MCP → Connected clients and reconnect, approving every permission you need. Using an MCP key? Edit its scopes in the same screen.
No phone numbers? Phone numbers aren’t included on the Free plan. On other plans, check that the connection was approved with the phones permission.
“Insufficient credits”? Check get_account_status and top up from the dashboard. Email verification uses a separate verification balance.
No match found? No credit charged. Try the contact’s LinkedIn URL — it’s the most reliable identifier.
FAQ
Which plans can use the MCP? All plans, including Free. Limits vary by plan — see Credits and limits.
Which AI tools work with it? Claude (web, desktop and mobile), Claude Code, ChatGPT (web), Codex, Gemini CLI, Cursor, Perplexity, VS Code, and any Streamable HTTP client.
What does it cost? Nothing on top of your plan. Searching, company enrichment, lookup, and get_account_status are free. Person enrichment uses enrichment credits, and email verification uses verification credits.
Can I use the REST API on Free or Basic? No. On Free and Basic, your key works with the MCP only. The REST API is available on Professional and Premium.
Is my data safe? Same account, same GDPR-aligned permissions as the API. See our Privacy Policy and DPA.