Authentication and connecting
Loading server catalog…. Download catalog
Advarde MCPAvailable subject to your connection’s permissions.
Description: Connect an MCP client to your workspace with OAuth or an MCP bearer token.
Documentation: Getting started
Output: See the protocol description and workflow notes below.
Access: Workspace-scoped MCP authentication.
Connect a client
Copy the MCP URL from MCP connections in your workspace. Choose OAuth in a compatible client and sign in to select a workspace. The client discovers the authorization server and completes authorization code + PKCE.
Bearer tokens
For clients that support bearer authentication, create an MCP token in MCP connections. Send Authorization: Bearer YOUR_MCP_TOKEN. This is an Advarde MCP token, not the upstream advertiser API key. Store it in your environment or client secret configuration.
Request headers
POST JSON-RPC messages to /mcp with Content-Type: application/json and Accept: application/json, text/event-stream. Initialize the connection and send notifications/initialized before tool requests. An MCP SDK handles the protocol lifecycle.
Credential expiry
MCP bearer tokens expire within 90 days. OAuth access tokens last one hour; refresh-token families last 30 days and rotate on use. Revoked, expired, or suspended credentials cannot be used.
Authentication
Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.
For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.
Responses
200Successful protocol response
Inspect result.isError for tool-level failures, even when the HTTP status is 200.
202Notification accepted
MCP notifications return no JSON-RPC response body.
400Invalid request
Check the JSON-RPC envelope, parameters, and protocol version.
406Not acceptable
Accept must include application/json and text/event-stream.
429Rate limited
Wait for the Retry-After interval before making another request.
401Unauthorized
A valid, unexpired MCP bearer token is required.
403Access denied
Your connection needs access to this workspace and the requested operation.