Skip to main content

DocsREST API and MCP server

MCP OAuth API

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

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

MCP OAuth

Get OAuth Server Metadata

OAuth 2.0 authorization server metadata (RFC 8414), which OAuth-capable MCP clients read to find where to register, where to send the user, and where to exchange codes. The authorization_endpoint is the GTM Scoop web app's consent page; the token and registration endpoints are on the API host, under /api/v1/longlat/oauth, which serves the same handlers as /api/v1/gtmscoop/oauth.

GEThttps://us-farmvision-new-api.onrender.com/.well-known/oauth-authorization-serverTry it

In this section

Authentication

No credentials

This route is what issues tokens for everything else, so it takes no auth header.

Parameters

This endpoint takes no parameters or request body.

Mounted at

/api/v1/gtmscoop/oauth

OAuth for MCP clients: exchange an API key for a short-lived access token, or let an OAuth-capable client (Claude, ChatGPT, Cursor, an app on the user's computer) register itself and connect on a user's behalf with authorization code + PKCE. Access tokens are Bearer tokens accepted wherever an API key is, and their calls count toward the account's daily MCP 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 3 endpoints in this section

No bearer token: /token authenticates with your API key as client_secret, a PKCE code, or a refresh token.

MethodPathWhat it does
GET/.well-known/oauth-authorization-server

Get OAuth Server Metadata

OAuth 2.0 authorization server metadata (RFC 8414), which OAuth-capable MCP clients read to find where to register, where to send the user, and where to exchange codes. The authorization_endpoint is the GTM Scoop web app's consent page; the token and registration endpoints are on the API host, under /api/v1/longlat/oauth, which serves the same handlers as /api/v1/gtmscoop/oauth.

POST/api/v1/gtmscoop/oauth/token

Get MCP Access Token

Issues a Bearer access token valid for 15 minutes (fields form-encoded; JSON also accepted) for one of three grants: client_credentials (your API key as client_secret), authorization_code with PKCE S256 (also returns a 180-day refresh_token and scope), or refresh_token (a new access token and scope; the refresh token itself is reused). Tokens stop working as soon as the underlying key or connection is revoked; errors carry OAuth codes (401 invalid_client; 400 invalid_request, invalid_grant or unsupported_grant_type). OAuth discovery metadata (authorize, token and registration endpoints) is served at GET /.well-known/oauth-authorization-server on the API host.

7 parameters
  • grant_type (string, required) client_credentials, authorization_code, or refresh_token.
  • client_secret (string) client_credentials: your llmcp_ API key. Alternatively send it with HTTP Basic auth (the key as the password).
  • code (string) authorization_code: the one-time code from the redirect. Single-use.
  • redirect_uri (string) authorization_code: exactly the redirect_uri used in the authorize request.
  • client_id (string) authorization_code: the client_id from Register OAuth Client.
  • code_verifier (string) authorization_code: the PKCE verifier whose S256 hash was sent as code_challenge.
  • refresh_token (string) refresh_token: the refresh_token from an authorization_code exchange.
POST/api/v1/gtmscoop/oauth/register

Register OAuth Client

Dynamic Client Registration (RFC 7591) for OAuth-capable MCP clients: returns a public client_id (no secret; PKCE is required) to use when sending the user to the authorization_endpoint from the discovery metadata and at /token. Other metadata such as client_name is ignored; the name on the consent screen comes from the redirect URI. 400 invalid_redirect_uri if any URI is not on the allowed list.

1 parameter
  • redirect_uris (string[], required) 1 to 10 callback URLs, each on the allowed list: Claude (https://claude.ai/api/mcp/auth_callback, https://claude.com/api/mcp/auth_callback), ChatGPT (https://chatgpt.com/connector_platform_oauth_redirect, https://chatgpt.com/connector/oauth/{id}), Cursor (https://www.cursor.com/agents/mcp/oauth/callback, cursor://anysphere.cursor-mcp/...), or a loopback http://localhost, 127.0.0.1 or [::1] URL on any port.

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