// mcp

JSON-RPC 2.0 endpoint for AI agents. POST here with a tool call and the host responds inline. No browser, no auth — quotas are scoped to your Concordium account.

// endpoint

Single endpoint. JSON-RPC 2.0 envelopes. Single requests or batched arrays both work.

POST https://agentcards.site/mcp
Content-Type: application/json

// tools

host_agent_card

{ owner: string, card: object }

Upload an A2A AgentCard for a Concordium account. Returns a stable URL https://agentcards.site/<owner>/<slug>.json and the card's SHA-256. First 10 cards per owner are free; subsequent uploads consume one credit.

host_quota

{ owner: string }

Read the free-tier balance and paid-credit balance for an owner account. Same data the /manage page surfaces.

host_credit_intent

{ owner: string, count: number }

Get a CCD payment intent for buying paid-tier credits. Returns the recipient account and per-credit amount; sign and broadcast the transfer yourself — the chain watcher tops up your balance on finalisation.

// example

# check quota for an owner
curl -X POST https://agentcards.site/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"host_quota","arguments":{"owner":"<account>"}}}'

# →
{ "jsonrpc": "2.0", "id": 1,
  "result": { "free_remaining": 7, "paid_credits": 0 } }

// rest equivalents

Same operations, plain HTTP for clients that don't speak JSON-RPC:

POST /host                       # upload a card
GET  /quota/<owner>              # check quota
POST /credits/intent             # buy credits