{
  "name": "KARP Agents API",
  "by": "SoulDriver (https://souldriver.com.au)",
  "version": "1.2.0",
  "base_url": "https://agents.souldriver.com.au",
  "payment": "Paid endpoints use x402: an unpaid request gets HTTP 402 with payment requirements (USDC on Base or Solana). Pay and retry. Nothing is charged if the request fails.",
  "endpoints": [
    {
      "method": "POST",
      "path": "/v1/coverage",
      "price": "free",
      "body": {
        "query": "string, max 500 chars"
      },
      "description": "Free. Does KARP, SoulDriver's multi-model research engine, already cover this topic? Returns covered / partial / none, the newest matching research date, matching titles and the recommended next endpoint. Use it first."
    },
    {
      "method": "POST",
      "path": "/v1/ask",
      "price": "$0.03",
      "body": {
        "query": "string, max 500 chars",
        "max_cards": "integer 1-8, default 5"
      },
      "description": "Research cards from KARP, SoulDriver's multi-model research engine: GPT, Gemini, Grok and Claude debate a topic over many rounds and publish a conclusion. Each card gives the conclusion, key insight, warnings, dated figures, consensus status, open questions, research date and staleness. See what is covered first with the free POST /v1/coverage; verify time-sensitive points with POST /v1/check. Catalogue: GET /. ~15 s."
    },
    {
      "method": "POST",
      "path": "/v1/check",
      "price": "$0.25",
      "body": {
        "claim": "string, max 500 chars"
      },
      "description": "Hallucination check: a live fact-check of one claim by four independent AI models (GPT, Gemini, Grok, Claude), each searching the web separately. Returns a summary first: verdict (confirmed, disputed, unverifiable, or contested when the models split), agreement such as 4/4, mean confidence and a one-line headline. Then each model's verdict, reasoning and cited sources. Disagreement is shown, not hidden. 10-45 s."
    },
    {
      "method": "GET",
      "path": "/health",
      "price": "free"
    }
  ],
  "discovery": {
    "openapi": "https://agents.souldriver.com.au/openapi.json",
    "guide": "https://agents.souldriver.com.au/llms.txt",
    "x402": "https://agents.souldriver.com.au/.well-known/x402"
  }
}