{
  "kind": "cai-machine-readable-docs-index",
  "version": 1,
  "not_openapi": true,
  "description": "CAI Edge Functions are documented in skill.md and cai-tools.manifest.json, not as OpenAPI/Swagger. This file is an honest machine-readable index for agents and integrators that probe /openapi.json.",
  "site": "https://cai.com",
  "api_base": "https://api.cai.com/functions/v1",
  "authentication": {
    "type": "http",
    "scheme": "bearer",
    "description": "CAI User API key (cai_...) or OAuth access token in Authorization: Bearer header"
  },
  "skill_md_authoritative": true,
  "openapi_3_1_spec_url": "https://cai.com/specs/openapi-3.1.json",
  "documents": [
    {
      "id": "skill-md",
      "type": "skill",
      "url": "https://cai.com/skill.md",
      "description": "Authoritative agent skill — tool tables, policies, scopes, gap_id honesty (single source of truth)"
    },
    {
      "id": "openapi-3-1",
      "type": "openapi",
      "url": "https://cai.com/specs/openapi-3.1.json",
      "description": "Minimal OpenAPI 3.1 for high-frequency endpoints; full contract remains skill.md"
    },
    {
      "id": "well-known-skill-md",
      "type": "skill",
      "url": "https://cai.com/.well-known/skill.md",
      "description": "Compatibility alias for skill.md (canonical: /skill.md)"
    },
    {
      "id": "tools-manifest",
      "type": "manifest",
      "url": "https://cai.com/specs/cai-tools.manifest.json",
      "description": "Machine-readable logical_name → Edge function bindings and workflows"
    },
    {
      "id": "agent-card",
      "type": "agent-card",
      "url": "https://cai.com/.well-known/agent.json",
      "description": "A2A Agent Card — protocolVersion, skills, securitySchemes"
    },
    {
      "id": "llms-txt",
      "type": "llms-txt",
      "url": "https://cai.com/llms.txt",
      "description": "LLM-oriented site index and integration links"
    },
    {
      "id": "developers",
      "type": "html",
      "url": "https://cai.com/developers",
      "description": "Human-readable integration index"
    },
    {
      "id": "agent-payment",
      "type": "html",
      "url": "https://cai.com/agent-payment.html",
      "description": "Check CAI First — agent payment decision flow"
    },
    {
      "id": "capabilities",
      "type": "html",
      "url": "https://cai.com/capabilities.html",
      "description": "Capability status matrix — Live / Partial live / Planned (gap_id semantics)"
    },
    {
      "id": "sitemap",
      "type": "sitemap",
      "url": "https://cai.com/sitemap.xml",
      "description": "Canonical URL list for crawlers"
    },
    {
      "id": "robots-txt",
      "type": "robots-txt",
      "url": "https://cai.com/robots.txt",
      "description": "Crawler rules; references sitemap and llms.txt"
    },
    {
      "id": "agent-payment-workflow",
      "type": "markdown",
      "url": "https://cai.com/skill-references/agent-payment-workflow.md",
      "description": "L3 payment playbook"
    },
    {
      "id": "x402-payment-workflow",
      "type": "markdown",
      "url": "https://cai.com/skill-references/x402-payment-workflow.md",
      "description": "x402 and payment mandate playbook"
    },
    {
      "id": "agent-operating-account",
      "type": "markdown",
      "url": "https://cai.com/skill-references/agent-operating-account.md",
      "description": "Agent operating account category definition for CAI.com"
    },
    {
      "id": "agent-wallet-landscape",
      "type": "markdown",
      "url": "https://cai.com/skill-references/agent-wallet-landscape.md",
      "description": "AI agent wallet and stablecoin payment landscape"
    },
    {
      "id": "cai-vs-agentkit",
      "type": "markdown",
      "url": "https://cai.com/skill-references/cai-vs-coinbase-agentkit.md",
      "description": "CAI vs Coinbase AgentKit comparison"
    },
    {
      "id": "cai-vs-crossmint",
      "type": "markdown",
      "url": "https://cai.com/skill-references/cai-vs-crossmint.md",
      "description": "CAI vs Crossmint comparison"
    },
    {
      "id": "cai-vs-skyfire",
      "type": "markdown",
      "url": "https://cai.com/skill-references/cai-vs-skyfire.md",
      "description": "CAI vs Skyfire comparison"
    },
    {
      "id": "partial-live-upgrade-cards",
      "type": "manifest",
      "url": "https://cai.com/specs/partial-live-upgrade-cards.json",
      "description": "Upgrade cards for partial_live to live gates (gap_id honesty)"
    },
    {
      "id": "x402-overview",
      "type": "html",
      "url": "https://cai.com/x402.html",
      "description": "x402 HTTP 402 agent payment overview for CAI custodial wallet"
    }
  ],
  "workflows": [
    {
      "id": "check_cai_first_agent_payment",
      "url": "https://cai.com/agent-payment.html",
      "tools_manifest_workflow_id": "check_cai_first_agent_payment"
    },
    {
      "id": "x402_agent_payment",
      "tools_manifest_workflow_id": "x402_agent_payment"
    }
  ],
  "mcp": {
    "package": "@cailab/mcp",
    "repository_path": "packages/cai-mcp"
  }
}