Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.adside.ai/llms.txt

Use this file to discover all available pages before exploring further.

Getting Started

1. Get an API key

API keys are provisioned through the web app’s workspace settings. Each key is prefixed with sk_live_* and grants access to the channels (Meta, LinkedIn, Google) connected in that workspace.

2. Make your first call

All MCP tools are called via POST /{source}/mcp using JSON-RPC 2.0:
curl -X POST http://localhost:3100/meta/mcp \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/call",
    "params": {
      "name": "list_meta_campaigns",
      "arguments": {
        "status": "ACTIVE",
        "limit": 5
      }
    }
  }'

3. Discover available tools

List all tools available for a source:
curl -X POST http://localhost:3100/meta/mcp \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "tools/list"
  }'

4. Understanding the response

MCP tool responses follow this structure:
{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"campaigns\": [...], \"pagination\": {...}}"
      }
    ]
  }
}
The result.content[0].text field contains a JSON-stringified payload with the actual data.

Available sources

SourceEndpointProtocol
MetaPOST /meta/mcpMCP (JSON-RPC 2.0)
LinkedInPOST /linkedin/mcpMCP (JSON-RPC 2.0)
Google AdsPOST /google-ads/mcpMCP (JSON-RPC 2.0)
Google SheetsGET/POST /google/sheets/*REST
Google DriveGET/POST /google/drive/*REST