{
  "name": "ODEI",
  "description": "Agent-access surface for ODEI: private World Model creation with the user, governed API access, Base USDC activation, and local runtime handoff.",
  "url": "https://api.odei.ai",
  "version": "0.5.0-agent-access",
  "provider": {
    "organization": "ODEI",
    "url": "https://api.odei.ai",
    "contact": "odei@odei.ai"
  },
  "protocols": ["REST", "OpenAPI", "x402-discovery"],
  "defaultInputModes": ["application/json"],
  "defaultOutputModes": ["application/json", "text/plain"],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true,
    "agentLedActivation": true,
    "localRuntimeHandoff": true
  },
  "authentication": {
    "schemes": ["bearer", "apiKey", "base_usdc_receipt"],
    "apiKey": {
      "in": "header",
      "name": "X-Api-Key",
      "issuedBy": "POST /api/agent-access/claim"
    },
    "receipt": {
      "network": "eip155:8453",
      "chain": "base",
      "asset": "USDC",
      "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x2b7005e7b4955b46e70107ac7604d5ece7fd0e7a"
    }
  },
  "payment": {
    "manifest": "https://api.odei.ai/.well-known/x402.json",
    "capabilitiesRegistry": "https://api.odei.ai/.well-known/odei-base-capabilities.json",
    "plans": "https://api.odei.ai/api/agent-access/plans",
    "quote": "https://api.odei.ai/api/agent-access/quote",
    "claim": "https://api.odei.ai/api/agent-access/claim",
    "receipt": "https://api.odei.ai/api/agent-access/claims/{claimId}",
    "network": "eip155:8453",
    "asset": "USDC",
    "x402ChallengePreview": {
      "status": "live",
      "schema": "x402.v2.http-resource-challenge",
      "resourceShape": "top_level_resource_accepts_paymentRequirements",
      "requestHeader": "Accept-Payment: x402",
      "responseStatus": 402,
      "responseHeader": "PAYMENT-REQUIRED",
      "amountField": "accepts[].amount",
      "compatibilityFields": ["accepts[].amountRaw", "accepts[].maxAmountRequired"],
      "mimeType": "application/json"
    },
    "x402Settlement": {
      "status": "planned",
      "requestHeader": "PAYMENT-SIGNATURE",
      "readinessGate": {
        "gate": "check:x402-activation-readiness",
        "command": "npm run check:x402-activation-readiness -- --require-configured --remote-host google-cloud-api --remote-audit-timeout-ms 20000",
        "mode": "read_only_invalid_signature_no_payment_no_base_no_cdp_no_llm"
      }
    }
  },
  "skills": [
    {
      "id": "agent-access-plans",
      "name": "Read Agent Access Plans",
      "description": "Discover ODEI activation and paid-access plans for agents.",
      "tags": ["agents", "commerce", "base", "free"],
      "endpoint": "GET /api/agent-access/plans"
    },
    {
      "id": "agent-access-quote",
      "name": "Request Agent Access Quote",
      "description": "Create a Base USDC quote for agent-led ODEI runtime activation.",
      "tags": ["agents", "commerce", "base", "quote"],
      "endpoint": "POST /api/agent-access/quote"
    },
    {
      "id": "agent-access-claim",
      "name": "Claim Activation Packet",
      "description": "Verify a Base USDC transfer and receive an activation packet plus API access token.",
      "tags": ["agents", "commerce", "base", "activation"],
      "endpoint": "POST /api/agent-access/claim"
    },
    {
      "id": "agent-access-receipt",
      "name": "Read Activation Receipt",
      "description": "Fetch the redacted activation receipt without replaying the API access token.",
      "tags": ["agents", "commerce", "base", "receipts"],
      "endpoint": "GET /api/agent-access/claims/{claimId}"
    },
    {
      "id": "world-model-query",
      "name": "World Model Query",
      "description": "Query the governed ODEI graph after activation.",
      "tags": ["graph", "query", "authenticated"],
      "endpoint": "POST /api/v2/world-model/query"
    },
    {
      "id": "guardrail-check",
      "name": "Guardrail Check",
      "description": "Validate a proposed action against ODEI governance.",
      "tags": ["guardrail", "governance", "authenticated"],
      "endpoint": "POST /api/v2/guardrail/check"
    }
  ],
  "endpoints": {
    "plans": "https://api.odei.ai/api/agent-access/plans",
    "quote": "https://api.odei.ai/api/agent-access/quote",
    "claim": "https://api.odei.ai/api/agent-access/claim",
    "receipt": "https://api.odei.ai/api/agent-access/claims/{claimId}",
    "docs": "https://api.odei.ai/docs/",
    "mcp_discovery": "https://api.odei.ai/.well-known/mcp.json",
    "mcp_endpoint": "https://api.odei.ai/mcp",
    "openapi": "https://api.odei.ai/openapi.json",
    "openapi_v2": "https://api.odei.ai/openapi-v2.yaml",
    "agent_manifest": "https://api.odei.ai/.well-known/agent.json",
    "x402_manifest": "https://api.odei.ai/.well-known/x402.json",
    "base_capabilities": "https://api.odei.ai/.well-known/odei-base-capabilities.json"
  },
  "operatingModel": {
    "human": "owner",
    "agent": "operator",
    "governance": "user-owned permissions and receipts",
    "runtime": "local-first desktop substrate"
  }
}