Getting started
HTTP API quickstart
Discover Nayori resources and inspect the public API before adding OAuth or payments.
Discovery · PublicSettlement · Testnet
The API origin is https://api.nayori.ai. Start with credential-free discovery.
curl -sS https://api.nayori.ai/health
curl -sS https://api.nayori.ai/supported
curl -sS https://api.nayori.ai/.well-known/agent.json
curl -sS https://api.nayori.ai/openapi.jsonThe paid resources intentionally return HTTP 402 without a payment:
curl -i https://nayori.ai/api/v1
curl -i https://nayori.ai/api/mpp/v1For x402, inspect PAYMENT-REQUIRED. For MPP, inspect WWW-Authenticate: Payment. Do not send a
wallet key, seed phrase or unsigned intent as proof. The client signs the exact Stacks transaction
inside its custody boundary.
Protected partner access
OAuth authorizes API and MCP calls only. It cannot authorize a transfer or sign a transaction. Partner enrollment remains invite-only while agent self-registration uses a distinct restricted scope.
curl -sS https://oauth.nayori.ai/.well-known/oauth-authorization-server
curl -sS https://api.nayori.ai/.well-known/oauth-protected-resourceContinue with OAuth, MCP, or the full API reference.

PerkOS