Skip to main content

DocsREST API and MCP server

GTM Scoop MCP server

Endpoints, auth and live samples for Audience Builder, Connect Data and CRM sync.

Base URLhttps://us-farmvision-new-api.onrender.com

Get started

MCP server

Connect GTM Scoop to your AI agent and it can run the same Audience Builder searches and counts your account can.

Server URL

https://gtm-loom-mcp.onrender.com/mcp

Paste 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 Code
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.

Open setup guide

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.

PluginEndpointWhat it coversPlans
Criteria Count/criteria/mcpAudience 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/mcpUpload 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/mcpYour 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_count counts the US companies that match a filter set, and generate_ai_business_criteria turns a plain-language description into those filters.
  • list_saved_criteria and get_saved_criteria reuse audiences you saved in Audience Builder.
  • create_upload, save_mapping, create_run and start_enrich_job enrich a list you paste or attach, and get_enrich_job reports its progress.
  • start_ai_match_job and get_ai_match_job find lookalike prospects for an enriched run.
  • list_purchases and get_purchase_records read the lists your account has unlocked.
  • get_my_profile, get_billing_plan and gtmscoop_platform_info tell the agent who you are, what your plan includes and what GTM Scoop does.

Connect it, client by client

  1. 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. 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. 3

    Claude Code

    Create an API key first, then run the claude mcp add command shown above in a terminal. --scope user makes GTM Scoop available in every project. Run claude mcp list and look for gtm-scoop marked as connected.
  4. 4

    Cursor and other clients

    Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a project) as an entry under mcpServers with the URL and an Authorization: Bearer llmcp_… header, as in the block below. Most clients that support remote MCP servers take the same shape.
~/.cursor/mcp.json
{
  "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.

PlanCalls a day (every route)Calls a minute (audience search and MCP)
Free1020
Starter3060
Growth50150

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.

Related

Cookies on GTM Scoop

Essential cookies keep you signed in and the site secure, and are always on. Optional cookies (Google Analytics) help us understand how the site is used. They are on by default, except in the EU/EEA, the UK and Switzerland, where they stay off until you choose Accept All Cookies; choose Essential Cookies Only to turn them off. We do not use advertising cookies and we do not sell or share your personal information. The site works the same whichever you choose. We keep a record of your choice with the date, your IP address and the page you were on. Cookie Policy · Privacy Policy