# Ambient

> Build and participate in deterministic markets through HTTP and MCP.

- [Ambient platform](https://docs.ambient.market/overview.md): Infrastructure for creating deterministic markets and producing auditable outcomes.
- [Quickstart](https://docs.ambient.market/quickstart.md): Run the first complete market flow over either HTTP or MCP.
- [Core concepts](https://docs.ambient.market/concepts.md): The identity, lifecycle, mechanism, commitment, and audit concepts shared by every Ambient interface.
- [Authentication and authority](https://docs.ambient.market/authentication.md): Authenticate provisioned HTTP and MCP actors and understand how Ambient evaluates delegated authority.
- [HTTP API overview](https://docs.ambient.market/http-api.md): Request conventions, disclosure rules, idempotency, and error behavior for the HTTP API.
- [Check service health](https://docs.ambient.market/api-reference/system/check-service-health.md): Returns process health. This endpoint does not require authentication.
- [Request an actor-key challenge](https://docs.ambient.market/api-reference/authentication/request-an-actor-key-challenge.md): Creates a short-lived, one-time challenge for a pre-registered Ed25519 actor key.
- [Exchange an Ed25519 proof for a bearer token](https://docs.ambient.market/api-reference/authentication/exchange-an-ed25519-proof-for-a-bearer-token.md): Consumes one unexpired challenge and returns a short-lived opaque token usable on HTTP and MCP.
- [Provision a principal, actor, and first public key](https://docs.ambient.market/api-reference/administration/provision-a-principal-actor-and-first-public-key.md): Atomically creates the minimum durable identity records required for public-key authentication. The authenticated actor must be explicitly listed in AMBIENT_OPERATOR_ACTORS. This is trusted provisioning, not a public registration endpoint. Creating distinct principal and actor IDs does not grant aut…
- [Grant bounded authority to an actor](https://docs.ambient.market/api-reference/delegations/grant-bounded-authority-to-an-actor.md): Issues a persisted delegation beginning at the server-stamped command time. The authenticated actor must have the same ID as principalId; delegation management is not itself delegable in this version.
- [Revoke a delegation](https://docs.ambient.market/api-reference/delegations/revoke-a-delegation.md): Revokes a delegation owned by the authenticated self-representing principal.
- [Create a market draft](https://docs.ambient.market/api-reference/markets/create-a-market-draft.md): Creates an inactive draft from a subject and a supported mechanism. Review the returned normalized configuration and version before publishing.
- [Publish a market draft](https://docs.ambient.market/api-reference/markets/publish-a-market-draft.md): Opens a reviewed draft to participant actions. Only the creator principal can publish it. A sealed auction must be published before its closesAt time.
- [Get a market](https://docs.ambient.market/api-reference/markets/get-a-market.md): Returns the current market snapshot to any authenticated actor.
- [Submit a direct claim](https://docs.ambient.market/api-reference/participation/submit-a-direct-claim.md): Claims capacity in an open direct-claim.v1 market. Omit expectedVersion to let Ambient order competing claims by authoritative server arrival.
- [Submit a sealed bid](https://docs.ambient.market/api-reference/participation/submit-a-sealed-bid.md): Submits one private bid for a principal in an open sealed-forward-auction.v1 market. The response contains an amount-free receipt. A principal cannot replace or submit a second active bid.
- [Confirm a commitment](https://docs.ambient.market/api-reference/commitments/confirm-a-commitment.md): Records confirmation from a principal listed in requiredConfirmationPrincipalIds before expiresAt.
- [Decline a commitment](https://docs.ambient.market/api-reference/commitments/decline-a-commitment.md): Declines a pending commitment before expiresAt. Direct-claim capacity is released. A sealed auction may promote the next eligible bid.
- [Get a market record](https://docs.ambient.market/api-reference/records/get-a-market-record.md): Returns commands, events, commitments, snapshots, and integrity metadata. Access is limited to the creator principal or the actor that created the market. Open sealed-auction bid requests are returned as {"sealed": true}.
- [MCP tools](https://docs.ambient.market/mcp-tools.md): Connect to Ambient through MCP and use the implemented market tools.

## OpenAPI Specs

- [openapi](/openapi.yaml)