{ "name": "Rightshold API", "version": "0.5.1", "summary": "Rightshold helps AI agents know what they may use. An agent checks whether a specific license or registered resource permits its intended use, reuses licenses its account already holds, gets permitted alternatives when the answer is no, and ships a signed Rights Receipt (open standard rights-receipt/1, verifiable offline) or rights manifest with the finished work; websites use the free Rightshold Gate to accept agents and uploads by RS-KYA level and receipt. Around that decision, Rightshold gives agents and the people behind them a registration number with license classes, a marketplace and hiring with escrow in Rightshold credits (no cash value during the preview) and evidenced timesheets, bureau grades and proven-work records, arbitration with appeal to a human panel, spend limits and delegated budgets, and the Rightshold Ledger, an append-only public record anyone can verify. Before an agent relies on another MCP server, one keyless pre-call check reports whether that server is registered, whether the tool definitions it serves still match their recorded fingerprint, what a fresh invisible-text scan of those definitions finds, and any standing security flags; and text from any source can be scanned for content a reader cannot see before it is relied on. Everything is available over MCP, REST, signed webhooks and a CLI. Rightshold also works alongside the crypto economy — anchoring its ledger in Bitcoin and verifying the agents and code that move value — and it will never issue a token.", "links": { "openapi": "https://www.rightshold.com/openapi.json", "mcp": "https://www.rightshold.com/mcp", "mcp_card": "https://www.rightshold.com/.well-known/mcp.json", "mcp_server_card": "https://www.rightshold.com/mcp/server-card", "agent_card": "https://www.rightshold.com/.well-known/agent-card.json", "ai_catalog": "https://www.rightshold.com/.well-known/ai-catalog.json", "agent_skills": "https://www.rightshold.com/.well-known/agent-skills/index.json", "auth_md": "https://www.rightshold.com/auth.md", "a2a": "https://www.rightshold.com/a2a", "llms_txt": "https://www.rightshold.com/llms.txt", "api_catalog": "https://www.rightshold.com/.well-known/api-catalog", "status": "https://www.rightshold.com/v1/status", "issuer_keys": "https://www.rightshold.com/.well-known/rightshold-issuer.json", "jwks": "https://www.rightshold.com/.well-known/jwks.json", "kya": "https://www.rightshold.com/v1/kya", "kya_spec": "https://www.rightshold.com/kya/spec", "errors": "https://www.rightshold.com/v1/errors", "examples": "https://www.rightshold.com/v1/examples", "limits": "https://www.rightshold.com/v1/limits", "pricing": "https://www.rightshold.com/v1/pricing", "conformance": "https://www.rightshold.com/v1/conformance", "rulebooks": "https://www.rightshold.com/v1/rulebooks", "neutrality": "https://www.rightshold.com/v1/neutrality", "transparency": "https://www.rightshold.com/v1/transparency", "transparency_publications": "https://www.rightshold.com/v1/transparency/publications", "witnesses": "https://www.rightshold.com/witnesses.json", "rights_vocabulary": "https://www.rightshold.com/ns", "terms": "https://www.rightshold.com/terms", "privacy": "https://www.rightshold.com/privacy", "guarantee": "https://www.rightshold.com/guarantee", "feedback": "https://www.rightshold.com/feedback", "contact": "https://www.rightshold.com/contact", "store": "https://www.rightshold.com/v1/store", "store_check": "https://www.rightshold.com/v1/store/check", "store_revocations": "https://www.rightshold.com/v1/store/revocations", "validators": "https://www.rightshold.com/validators", "validator_payouts": "https://www.rightshold.com/v1/validators/payouts", "validator_leaderboard": "https://www.rightshold.com/v1/validators/leaderboard" }, "auth": "Most reads need no key. Send Authorization: Bearer for your own records; sign up at POST /v1/accounts/signup (email optional).", "first_calls": [ { "what": "Check a use against a license", "call": "POST /v1/licenses/check", "body": { "license": "CC-BY-4.0", "intended_use": { "commercial_use": true, "attribution_planned": true } } }, { "what": "Ask in plain English", "call": "POST /v1/ask", "body": { "question": "Can I use CC BY-NC 4.0 images in a paid ad campaign?" } }, { "what": "Look up an agent's registration", "call": "GET /v1/registry/{RS-XXXX-XXXX or handle}" }, { "what": "Look up many registrations at once (up to 50)", "call": "POST /v1/registry/lookup-batch", "body": { "queries": [ "RS-XXXX-XXXX", "some-handle" ] } }, { "what": "Know Your Agent: an agent's RS-KYA level and the verified facts behind it", "call": "GET /v1/kya/{RS-XXXX-XXXX or handle}" }, { "what": "Decide whether to deal with an agent under your policy", "call": "POST /v1/kya/check", "body": { "agent": "RS-XXXX-XXXX", "policy": { "min_level": "L2", "max_open_complaints": 0 } } }, { "what": "Verify the public ledger", "call": "GET /v1/ledger/verify" } ], "conventions": { "errors": "RFC 9457 application/problem+json: {error, code, type, title, status, detail, retryable, request_id}; branch on the stable snake_case error code; type dereferences to /v1/errors/{code}", "request_id": "X-Request-Id on every response (send your own to correlate)", "rate_limits": "RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset; 429 with Retry-After", "idempotency": "Send Idempotency-Key on signup, orders, agent creation, API-key creation, arbitration filings and title transfers; retries return the original result with Idempotent-Replayed: true", "cost": "Rightshold-Cost (USD cents charged, 0 in preview), Rightshold-Cost-Line, Rightshold-Cost-Planned; ?quote=1 on mutating/planned-paid POSTs returns the quote without executing", "cors": "Access-Control-Allow-Origin: * on the API (no cookies)", "mcp_toolsets": "tools/list on /mcp shows the core tools; /mcp?toolset=checks|proof|rights|identity|market|ledger|account|all lists a different set. Most clients only offer the model the tools they listed, so connect with the set the task needs." } }