Get started
MCP server
Server URL
https://gtm-loom-mcp.onrender.com/mcpPaste this into your AI app. It uses the streamable HTTP transport.
Chat apps
Claude and ChatGPT connect with OAuth, so no key is needed.
- Add a custom connector (Claude) or create a plugin (ChatGPT).
- Paste the server URL and leave advanced OAuth fields empty.
- Click Connect, sign in to GTM Scoop, then Allow.
Code tools
Claude Code and Cursor send your API key as a Bearer header.
claude mcp add --transport http --scope user gtm-scoop \ https://gtm-loom-mcp.onrender.com/mcp \ --header "Authorization: Bearer llmcp_YOUR_KEY"
Step-by-step setup for every client
Claude, ChatGPT, Claude Code and Cursor, with screenshots of each screen.
What your agent can do
GTM Scoop's MCP server gives an AI agent the same audience counts, list enrichment and prospect data your account has in the web app. It is split into 3 plugins, each with its own endpoint, and together they register more than 60 tools.
| Plugin | Endpoint | What it covers | Plans |
|---|---|---|---|
| Criteria Count | /criteria/mcp | Audience counts and AI-drafted criteria for every dataset, saved criteria, plan and checkout links, and a criteria dashboard drawn in the chat. | Every plan, Free included |
| AI & Enrichment | /enrichment/mcp | Upload a list, map its columns, run enrichment and AI analysis jobs, read results and match summaries, and pull contacts in from HubSpot or Salesforce. | Starter and Growth |
| Purchased User | /purchased/mcp | Your unlocked lists and their records, with a purchases dashboard in the chat. | Starter and Growth |
The main URL above, ending in /mcp, exposes every plugin a paid account can use and only Criteria Count to a Free account. Connect a single plugin by swapping /mcp for its endpoint. A Free account that calls a paid plugin gets 403.
Tools agents use most
business_search_countcounts the US companies that match a filter set, andgenerate_ai_business_criteriaturns a plain-language description into those filters.list_saved_criteriaandget_saved_criteriareuse audiences you saved in Audience Builder.create_upload,save_mapping,create_runandstart_enrich_jobenrich a list you paste or attach, andget_enrich_jobreports its progress.start_ai_match_jobandget_ai_match_jobfind lookalike prospects for an enriched run.list_purchasesandget_purchase_recordsread the lists your account has unlocked.get_my_profile,get_billing_planandgtmscoop_platform_infotell the agent who you are, what your plan includes and what GTM Scoop does.
Connect it, client by client
- 1
Claude (desktop app or claude.ai)
Go to Settings → Connectors and click "Add custom connector". Name it GTM Scoop, paste the server URL and leave the OAuth Client ID and Secret empty. Click Add, then Connect, sign in with Google or an emailed code, and click Allow. Switch GTM Scoop on in a new chat's tools menu. - 2
ChatGPT
Open Settings → Plugins (turn on Developer mode under Advanced settings if there is no Create button) and click Create. Choose Server URL, paste the URL ending in/mcp, set Authentication to OAuth and leave the advanced fields empty. Create the plugin, click Connect, sign in and click Allow. It needs a Plus, Pro, Business, Enterprise or Edu plan. - 3
Claude Code
Create an API key first, then run theclaude mcp addcommand shown above in a terminal.--scope usermakes GTM Scoop available in every project. Runclaude mcp listand look for gtm-scoop marked as connected. - 4
Cursor and other clients
Add the server to~/.cursor/mcp.json(or.cursor/mcp.jsonin a project) as an entry undermcpServerswith the URL and anAuthorization: Bearer llmcp_…header, as in the block below. Most clients that support remote MCP servers take the same shape.
{
"mcpServers": {
"gtm-scoop": {
"url": "https://gtm-loom-mcp.onrender.com/mcp",
"headers": {
"Authorization": "Bearer llmcp_YOUR_KEY"
}
}
}
}To check the connection, ask the agent "What GTM Scoop tools do you have access to?", then a real question such as "How many software companies in Texas have 50 to 99 employees?" A number back, not a refusal, means it works. A key labelled as a connected app also appears under Profile → MCP & API keys.
Transport and authentication
The server uses the streamable HTTP transport, stateless: every message is a POST to the endpoint and every reply is plain JSON, so GET and DELETE return 405. A request with no credentials gets 401 with a WWW-Authenticate header that points the client to the OAuth metadata; that is how Claude and ChatGPT find the GTM Scoop sign-in page. Code tools send an API key instead, as Authorization: Bearer llmcp_… (a bare Authorization: llmcp_… or an X-API-Key: llmcp_… header also works). Errors come back as JSON-RPC errors.
Limits
MCP calls use your plan's daily and per-minute limits, and count toward the same daily total as API calls. Checking a job's status does not count toward the daily limit, so an agent can follow a long enrichment without using up the day. The server also allows 120 requests a minute from one IP address.
| Plan | Calls a day (every route) | Calls a minute (audience search and MCP) |
|---|---|---|
| Free | 10 | 20 |
| Starter | 30 | 60 |
| Growth | 50 | 150 |
Troubleshooting
- The client says the server needs authorization: connect it again and sign in. Chat apps refresh their tokens on their own, but a revoked or replaced connection needs a new sign-in.
- 403 on a plugin: that plugin needs a Starter or Growth plan. Compare plans.
- "unknown client_id" in ChatGPT: open the plugin page, use Manage app → Delete app (not Uninstall), and create it again.
- 429 "Daily MCP limit reached": the limit resets at midnight (server time), or a GTM Scoop admin can raise it for your account.