API-referentie

Streamable HTTP MCP.

Eén endpoint, één bearer-token, JSON-RPC 2.0. Hieronder de meest voorkomende calls met live request/response voorbeelden.

v1 stable· MCP-spec 2025-06-18

Endpoint

POST https://mcp.adocean.nl/mcp

Authenticatie

Bearer-token in de Authorization-header. Tokens beginnen met ado_live_ en zijn scoped aan één workspace.

Authorization: Bearer ado_live_xxxxxxxxxxxx

Headers

Content-Type: application/json
Accept: application/json, text/event-stream

Snel beginnen

1. Maak een account → /sign-in
2. Koppel Meta in /integrations
3. Genereer een token in /tokens
4. cURL of code hieronder

Veelgebruikte endpoints

Klik een endpoint om request/response te zien.

POST/mcp

Lijst alle beschikbare tools

Roept tools/list aan via JSON-RPC. Geeft alle 41 Meta-tools terug met JSON Schema voor input.

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Response200 OK

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "get_ad_accounts",
        "description": "List all Meta ad accounts the user has access to",
        "inputSchema": {
          "type": "object",
          "properties": {},
          "required": []
        }
      },
      ...
    ]
  }
}

Error-codes

adocean-specifieke errors bovenop de standaard MCP / JSON-RPC codes.

Code

Wat het betekent

plan_limit_exceeded

Maandelijkse MCP-call quota overschreden. Upgrade of wacht op de 1e van de volgende maand.

rate_limit_exceeded

Burst-limit (60 calls/minuut) bereikt. Retry-After header geeft cooldown in seconden.

token_revoked

Bearer-token is gerevoked of bestaat niet meer.

no_connection

Geen ad-platform gekoppeld voor deze workspace. Koppel via /integrations.

upstream_error

Meta/Google/TikTok API gaf een fout terug. Details in error.data.upstream.

Geen full SDK referentie hier?

De volledige tool-catalogus haal je op via tools/list — elke tool heeft zijn eigen JSON Schema. Je IDE of LLM-client doet de auto-completion voor je.

GitHub