Skip to main content

DocsREST API and MCP server

API Keys API

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

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

Account: API Keys

Get MCP Entitlement

The account's MCP tier and limits, derived from its billing plan: free (10 calls/day, 20/min), starter (30/day, 60/min) or growth (50/day, 150/min). null means unlimited (admin accounts); overridden is true when a custom daily limit has been set for the account.

GEThttps://us-farmvision-new-api.onrender.com/api/v1/gtmscoop/api-keys/entitlementTry it

In this section

Authentication

Get API key

Bearer token

Send your GTM Scoop API key (llmcp_…) or a signed-in session token as a Bearer token.

Authorization: Bearer YOUR_API_KEY

Parameters

This endpoint takes no parameters or request body.

Mounted at

/api/v1/gtmscoop/api-keys

Self-service llmcp_ API keys for the signed-in GTM Scoop account, used by the MCP server and direct API integrations. An account has one self-created key at a time: a new key replaces the old one. Connected apps (Claude, ChatGPT) have keys of their own, which that doesn't affect. Every account gets MCP access at the tier its billing plan maps to, and each call made with an API key or MCP token counts toward that tier's daily limit.

Try it in the playground

Signed out: 10 free tries a day with names hidden. Log in for live data.

Open playground

Related endpoints

All 4 endpoints in this section

Bearer token (API key or session); creating a key needs a signed-in web-app session.

MethodPathWhat it does
GET/api/v1/gtmscoop/api-keys/entitlement

Get MCP Entitlement

The account's MCP tier and limits, derived from its billing plan: free (10 calls/day, 20/min), starter (30/day, 60/min) or growth (50/day, 150/min). null means unlimited (admin accounts); overridden is true when a custom daily limit has been set for the account.

Try Get MCP Entitlement in the Playground
GET/api/v1/gtmscoop/api-keys/mine

List My API Keys

The account's live (unrevoked) keys, newest first, with call counts for today and the last 7 days. Includes the keys behind connected MCP apps (labelled like "Claude (connected 11/2/2026)"); the full key is never returned here, only keyPrefix.

Try List My API Keys in the Playground
POST/api/v1/gtmscoop/api-keys/mine

Create API Key

Creates a new llmcp_ key for the account and returns it in plaintext this one time only; it cannot be retrieved again. It replaces the account's older self-created keys, whose ids come back in replacedKeyIds: they stop working on this API at once and on the MCP server within a minute. Connected apps' keys are not affected. Requires a signed-in web-app session: a request authenticated with an API key or MCP token gets 403, so a leaked key cannot mint its own replacements.

2 parameters
  • label (string) A name for the key, up to 150 characters. Defaults to "Self-service key".
  • role (string) "user" (default) or "admin". "admin" only takes effect for a GTM Scoop admin account; anyone else gets a user key.
DELETE/api/v1/gtmscoop/api-keys/mine/:id

Revoke API Key

Revokes one of the account's keys immediately. Revoking a connected MCP app's key disconnects that app: its access and refresh tokens stop working at once. 404 if the id is unknown, belongs to another account, or is already revoked.

1 parameter
  • id (string, required) The key's id, from List My API Keys.

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