{
  "name": "Ambient",
  "version": "v0",
  "releaseStatus": "developer_preview",
  "lastUpdated": "2026-09-30",
  "description": "A runtime for creating, discovering, participating in, and recording deterministic markets for goods and services through HTTP and MCP.",
  "documentation": "https://docs.ambient.market",
  "publicConsole": "https://console.ambient.market",
  "completeDocumentationCorpus": "https://docs.ambient.market/llms-full.txt",
  "authenticationDocumentation": "https://docs.ambient.market/authentication",
  "paymentDocumentation": "https://docs.ambient.market/payments",
  "agentResources": {
    "skill": "https://github.com/ambient-market/ambient-skills",
    "installation": "npx skills add ambient-market/ambient-skills --agent codex",
    "guide": "https://docs.ambient.market/agent-resources",
    "recipes": "https://docs.ambient.market/recipes",
    "javascriptSDK": "https://www.npmjs.com/package/@ambient-market/sdk",
    "javascriptSDKSource": "https://github.com/ambient-market/sdk"
  },
  "interfaces": {
    "http": {
      "contract": "https://docs.ambient.market/openapi.yaml",
      "productionBaseUrl": "https://api.ambient.market",
      "runtimeBaseUrl": "provisioned per environment",
      "supportsSignup": true,
      "supportsDelegationManagement": true
    },
    "mcp": {
      "reference": "https://docs.ambient.market/mcp-tools",
      "productionUrl": "https://api.ambient.market/mcp",
      "runtimePath": "/mcp",
      "transport": "stateless Streamable HTTP",
      "supportsSignup": false,
      "supportsDelegationManagement": false
    }
  },
  "authentication": {
    "agentSelfRegistration": "Ed25519 key challenge and proof over HTTP",
    "humanSignupAndLogin": "email code over HTTP",
    "agentLedDelegation": "email-approved bounded scopes and expiry over HTTP",
    "runtimeCredential": "short-lived bearer token usable over HTTP and MCP",
    "controlledDeploymentCredential": "optional static bootstrap MCP token",
    "oauth": {
      "implementationStatus": "implemented",
      "documentation": "https://docs.ambient.market/oauth-connections",
      "clientRegistration": "dynamic_or_pre_registered",
      "grantTypes": ["authorization_code", "refresh_token"],
      "pkceMethods": ["S256"],
      "paymentScopes": false
    }
  },
  "mechanisms": [
    {
      "id": "direct-claim.v1",
      "status": "implemented",
      "allocation": "first valid participant, optionally requiring confirmation"
    },
    {
      "id": "sealed-forward-auction.v1",
      "status": "implemented",
      "allocation": "private bids with timed second-price clearing and winner confirmation"
    },
    {
      "id": "request-for-offers.v1",
      "status": "implemented",
      "selection": "requester after offer deadline",
      "offerVisibility": "scoped private read"
    },
    {
      "id": "lottery.v1",
      "status": "implemented",
      "allocation": "equal-weight draw from one active entry per principal",
      "confirmation": "immediate or creator eligibility review",
      "funding": "unfunded only"
    }
  ],
  "actions": [
    "actor-context:read",
    "market-creation-guide:read",
    "market:create",
    "market:publish",
    "market:cancel",
    "market:list",
    "market:read",
    "market-activity:read",
    "market:claim",
    "market:bid",
    "market:offer_submit",
    "market:offer_withdraw",
    "market:offer_read_scoped",
    "market:offer_select",
    "market:lottery_enter",
    "market:lottery_withdraw",
    "market:lottery_review",
    "market-outcome:read_scoped",
    "market-record:read",
    "commitment:confirm",
    "commitment:decline",
    "commitment:refund",
    "payee-rail:register",
    "payment:authorize",
    "payment-operation:read"
  ],
  "authorityScopes": [
    "market:create",
    "market:publish",
    "market:cancel",
    "market:claim",
    "market:bid",
    "market:offer_submit",
    "market:offer_select",
    "market:lottery_enter",
    "commitment:confirm",
    "commitment:decline",
    "commitment:refund",
    "credential:issue",
    "payment:authorize",
    "payment:register_payee_rail"
  ],
  "disclosure": {
    "public": [
      "published market discovery",
      "published market snapshot",
      "safe market activity"
    ],
    "participant": [
      "represented principal's own bid receipts",
      "represented principal's own offer states",
      "represented principal's own lottery entry history",
      "represented principal's own commitments"
    ],
    "creator": [
      "authorized ordered market record",
      "selected lottery candidates during review; complete lottery audit after resolution"
    ]
  },
  "funding": {
    "modes": ["none", "reserve_on_submission"],
    "authorization": "participant initiated, bounded, and asynchronous",
    "settlement": "system driven after a terminal commitment decision",
    "refund": "creator-authorized full refund after settlement",
    "adapterStatus": [
      { "kind": "deterministic fake rail", "status": "test only" },
      { "kind": "Stripe Connect card adapter", "status": "sandbox verified" }
    ]
  },
  "httpOnlyControlPlane": [
    "agent-signup",
    "human-email-signup-and-login",
    "agent-led-delegation-approval",
    "delegation:issue",
    "delegation:revoke",
    "trusted-identity:provision",
    "credential:issue",
    "credential:read",
    "credential:revoke"
  ],
  "notImplemented": [
    "key rotation",
    "portable W3C verifiable credentials",
    "general account-management UI",
    "MCP signup and delegation tools",
    "self-service production payee onboarding",
    "production rail reconciliation",
    "escrow",
    "partial refunds",
    "participant-initiated refund policy",
    "disputes and chargebacks",
    "fulfillment orchestration",
    "offer negotiation",
    "automated provider ranking",
    "rolling selection"
  ]
}