{"name":"Stakao Agent Recommendations","description":"Machine-readable entrypoint for agents buying Stakao Bittensor allocation recommendations with x402.","canonical_url":"https://api.stakao.com/agent","recommendations_url":"https://api.stakao.com/agent/recommendations","llms_txt_url":"https://api.stakao.com/agent/llms.txt","human_url":"https://stakao.com","protocol":{"payment":"x402","x402_version":2,"rail":"USDC","network":"base","x402_network":"eip155:8453","facilitator_url":"https://api.cdp.coinbase.com/platform/v2/x402","price":"3 USDC","pay_to":"0x322a03592CA40ed9faBA2CDF772952bBE9868C45"},"endpoints":{"catalog":{"method":"GET","url":"https://api.stakao.com/agent/recommendations/catalog","payment_required":false,"description":"Public catalog of Stakao products available to autonomous agents."},"reference_status":{"method":"GET","url":"https://api.stakao.com/agent/recommendations/reference-status","payment_required":false,"description":"Freshness status for hourly 50 TAO reference allocations."},"openapi":{"method":"GET","url":"https://api.stakao.com/agent/openapi.json","payment_required":false,"description":"OpenAPI description for the agent recommendation API."},"mcp":{"method":"POST","url":"https://api.stakao.com/agent/mcp","payment_required":false,"description":"Public read-only MCP JSON-RPC endpoint for catalog, manifest, pricing, and safety tools. It requires no OAuth and exposes no account-bound user data."},"search":{"method":"GET or POST","url":"https://api.stakao.com/agent/search","payment_required":false,"description":"Public Cloudflare AI Search over Stakao website content, docs, blog posts, agent discovery files, and safety pages.","request_schema":{"query":"natural-language search query","max_results":"optional integer from 1 to 10"}},"allocation":{"method":"POST","url":"https://api.stakao.com/agent/recommendations/allocation","payment_required":true,"preflight_url":"https://api.stakao.com/agent/recommendations/allocation/preflight","status_without_preflight_request_id":428,"payment_status_without_signature":402,"description":"Paid allocation recommendation. Agents must first call the free preflight endpoint. Preflight validates the request and returns a Stakao-generated request id/quote to include in the paid body. Creates agent_decisions.status=RECOMMENDED and never executes on-chain staking.","request_schema":{"wallet_address":"Bittensor SS58 wallet address to allocate","catalog_item_id":"Catalog item id from GET /agent/recommendations/catalog","config":"optional object","client_request_id":"Required Stakao-generated request id returned by POST /agent/recommendations/allocation/preflight."}}},"security":{"recommendation_only":true,"executes_on_chain":false,"catalog_public":true,"mcp_auth_required":false,"mcp_exposes_account_bound_data":false,"allocation_requires_x402_payment":true,"backend_accepts_worker_signed_requests_only":true}}