{"openapi":"3.1.0","info":{"title":"Tink agent API","version":"1.0.0","description":"Required: /llms.txt, /agents.md, and POST /v1/keys (402 pay_url for Mechanic $9). Install first: curl -fsSL https://tink.bot/install | sh. Cursor/Claude Code skill /skill.md. Public Streamable HTTP MCP at /mcp (server.json). /api/mcp is an alias."},"servers":[{"url":"https://tink.bot"}],"paths":{"/v1/keys":{"post":{"summary":"Start Mechanic (or Crew Chief / Rescue) key checkout","operationId":"createAgentKey","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"string","enum":["mechanic","crew-chief","rescue"],"default":"mechanic"}}}}}},"responses":{"402":{"description":"Unpaid. Follow pay_url, then poll claim_url.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unpaid"}}}}}}},"/v1/keys/claims/{id}":{"get":{"summary":"Claim the minted key once","operationId":"claimAgentKey","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Secret returned once"},"202":{"description":"Processing"},"402":{"description":"Unpaid — pay_url present"},"409":{"description":"Replay"},"410":{"description":"Expired"}}}},"/v1/status":{"get":{"summary":"Paid status resource","operationId":"getPaidStatus","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Key is live"},"401":{"description":"Bad key"},"402":{"description":"Unpaid — POST /v1/keys for pay_url"}}}},"/v1/scan":{"get":{"summary":"Paid scan alias of /v1/status","operationId":"getPaidScan","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Key is live"},"401":{"description":"Bad key"},"402":{"description":"Unpaid"}}}},"/mcp":{"get":{"summary":"Public Streamable HTTP MCP (JSON manifest, or SSE when Accept: text/event-stream)","operationId":"getMcp"},"post":{"summary":"MCP JSON-RPC 2.0. initialize and tools/list are open; tools/call needs Bearer.","operationId":"postMcp"}},"/api/mcp":{"get":{"summary":"Alias of /mcp","operationId":"getMcpAlias"},"post":{"summary":"Alias of /mcp","operationId":"postMcpAlias"}},"/server.json":{"get":{"summary":"MCP registry document (streamable-http remotes)","operationId":"getMcpServerJson"}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Unpaid":{"type":"object","required":["error","pay_url","claim_url"],"properties":{"error":{"const":"unpaid"},"pay_url":{"type":"string","format":"uri","description":"Live Stripe Checkout URL (not a catalog price_ ID)"},"claim_url":{"type":"string","format":"uri"},"plan":{"type":"string"},"price":{"type":"string"},"amount_cents":{"type":"integer"},"human_checkout":{"type":"string","format":"uri","description":"Secondary human page, e.g. /checkout?plan=mechanic"}}}}}}