Discover
Read /agent.json, /agent.md, /llms.txt, and OpenAPI before acting.
Token Robin Hood / agent interface
Interface for agents.
Use these stable surfaces instead of browser-clicking the human landing page. They expose discovery, purchase, install, download, CLI auth, license validation, and support paths with typed contracts.
Use
Start CLI auth sessions, validate licenses, install the CLI, and download the wheel without reverse-engineering the DOM.
Contact
Use /api/contact with a stable draft_id, or send the human to support for refunds and setup help.
{
"schema": "https://tokenrobinhood.lat/schemas/agent-interface.v1.json",
"id": "token-robin-hood",
"name": "Token Robin Hood",
"version": "0.1.4",
"site_url": "https://tokenrobinhood.lat",
"human_home": "https://tokenrobinhood.lat/",
"agent_home": "https://tokenrobinhood.lat/agent",
"llms_txt": "https://tokenrobinhood.lat/llms.txt",
"openapi": "https://tokenrobinhood.lat/agent/openapi.json",
"markdown_guide": "https://tokenrobinhood.lat/agent.md",
"support": {
"email": "access@tokenrobinhood.lat",
"page": "https://tokenrobinhood.lat/support",
"api": "https://tokenrobinhood.lat/api/contact"
},
"product": {
"category": "developer_cli",
"summary": "TRH helps Claude Code and Codex users reduce token waste from verbose agent output, repeated narration, and noisy research loops.",
"not_a_limit_bypass": true,
"local_first_positioning": true,
"price": {
"lifetime_access_v2": {
"amount_cents": 990,
"display": "$9.90",
"currency": "USD",
"billing": "one_time"
}
}
},
"auth": {
"public_discovery": "none",
"purchase": "Stripe checkout URL returned by /api/checkout",
"cli": "license_key plus installation_hash",
"human_claim_url": "https://tokenrobinhood.lat/auth/cli/{session_id}",
"service_account": "not_available_yet",
"scopes": [
"license:validate",
"auth_session:start",
"auth_session:claim",
"support:write",
"checkout:create"
]
},
"capabilities": [
"discover_capabilities",
"read_machine_docs",
"join_waitlist",
"start_checkout",
"contact_support",
"start_cli_auth_session",
"claim_cli_auth_session",
"poll_cli_auth_session",
"validate_license",
"install_cli",
"download_package"
],
"retry_policy": {
"safe_reads": [
"GET /agent.json",
"GET /agent.md",
"GET /llms.txt",
"GET /agent/openapi.json",
"GET /install"
],
"safe_retries_with_same_key": [
"POST /api/waitlist using same email",
"POST /api/contact using same draft_id"
],
"avoid_blind_retries": [
"POST /api/checkout",
"POST /v1/auth/sessions/start",
"POST /v1/auth/sessions/claim"
]
},
"resources": {
"docs": [
"https://tokenrobinhood.lat/llms.txt",
"https://tokenrobinhood.lat/agent.md",
"https://tokenrobinhood.lat/agent/openapi.json"
],
"package": [
"https://tokenrobinhood.lat/install",
"https://tokenrobinhood.lat/downloads/token_robin_hood-0.1.4-py3-none-any.whl"
],
"human_pages": [
"https://tokenrobinhood.lat/",
"https://tokenrobinhood.lat/blog",
"https://tokenrobinhood.lat/support",
"https://tokenrobinhood.lat/privacy",
"https://tokenrobinhood.lat/terms"
]
},
"endpoints": [
{
"id": "discover_agent_interface",
"method": "GET",
"path": "/agent.json",
"url": "https://tokenrobinhood.lat/agent.json",
"description": "Machine-readable product, capability, auth, purchase, install, download, and support map.",
"side_effect": "none",
"auth": "none",
"output": "AgentInterface"
},
{
"id": "read_agent_guide",
"method": "GET",
"path": "/agent.md",
"url": "https://tokenrobinhood.lat/agent.md",
"description": "Markdown guide optimized for LLM and coding-agent consumption.",
"side_effect": "none",
"auth": "none",
"output": "text/markdown"
},
{
"id": "read_openapi",
"method": "GET",
"path": "/agent/openapi.json",
"url": "https://tokenrobinhood.lat/agent/openapi.json",
"description": "Compact OpenAPI 3.1 description of the stable agent-facing endpoints.",
"side_effect": "none",
"auth": "none",
"output": "application/openapi+json"
},
{
"id": "join_waitlist",
"method": "POST",
"path": "/api/waitlist",
"url": "https://tokenrobinhood.lat/api/waitlist",
"description": "Register an email interest/access lead. Deduplicates by email.",
"side_effect": "write",
"auth": "none",
"input_schema": {
"properties": {
"email": {
"title": "Email",
"type": "string"
},
"source": {
"default": "landing_page",
"title": "Source",
"type": "string"
},
"offer": {
"default": "",
"title": "Offer",
"type": "string"
},
"pricing_variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricing Variant"
},
"selected_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Selected Agent"
}
},
"required": [
"email"
],
"title": "WaitlistRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"created": {
"type": "boolean"
}
},
"required": [
"ok",
"created"
]
},
"idempotency": "Email dedupe makes repeated identical submissions safe."
},
{
"id": "start_checkout",
"method": "POST",
"path": "/api/checkout",
"url": "https://tokenrobinhood.lat/api/checkout",
"description": "Create a Stripe checkout session for a supported offer.",
"side_effect": "external_checkout_session",
"auth": "none",
"input_schema": {
"properties": {
"email": {
"title": "Email",
"type": "string"
},
"offer": {
"title": "Offer",
"type": "string"
},
"source": {
"default": "landing_page",
"title": "Source",
"type": "string"
},
"pricing_variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Pricing Variant"
},
"selected_agent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Selected Agent"
},
"auth_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Auth Session Id"
},
"coupon_code": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Coupon Code"
},
"recovery_session_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recovery Session Id"
},
"recovery_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Recovery Token"
}
},
"required": [
"email",
"offer"
],
"title": "CheckoutRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"url": {
"type": "string"
},
"conversion_id": {
"type": "string"
}
},
"required": [
"ok",
"url",
"conversion_id"
]
},
"idempotency": "Not globally idempotent. Reuse the same email/offer and prefer a single checkout URL per user action."
},
{
"id": "contact_support",
"method": "POST",
"path": "/api/contact",
"url": "https://tokenrobinhood.lat/api/contact",
"description": "Create or update a support/contact draft, and submit it when submitted=true.",
"side_effect": "write",
"auth": "none",
"input_schema": {
"properties": {
"draft_id": {
"title": "Draft Id",
"type": "string"
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Email"
},
"twitter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Twitter"
},
"instagram": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Instagram"
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Website"
},
"topic": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Topic"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"source": {
"default": "landing_page",
"title": "Source",
"type": "string"
},
"submitted": {
"default": false,
"title": "Submitted",
"type": "boolean"
}
},
"required": [
"draft_id"
],
"title": "ContactInquiryRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"submitted": {
"type": "boolean"
}
},
"required": [
"ok",
"submitted"
]
},
"idempotency": "Use a stable draft_id for retries or autosaves."
},
{
"id": "start_cli_auth_session",
"method": "POST",
"path": "/v1/auth/sessions/start",
"url": "https://tokenrobinhood.lat/v1/auth/sessions/start",
"description": "Start a browser-claimable CLI auth session for a local installation.",
"side_effect": "write",
"auth": "none",
"input_schema": {
"properties": {
"installation_hash": {
"title": "Installation Hash",
"type": "string"
},
"source": {
"default": "all",
"title": "Source",
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Version"
}
},
"required": [
"installation_hash"
],
"title": "AuthSessionStartRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"session_id": {
"type": "string"
},
"auth_url": {
"type": "string"
},
"poll_url": {
"type": "string"
},
"expires_at": {
"type": "string"
}
},
"required": [
"ok",
"session_id",
"auth_url",
"poll_url",
"expires_at"
]
},
"idempotency": "Creates a new session on each call. Retry only after losing the prior session_id."
},
{
"id": "claim_cli_auth_session",
"method": "POST",
"path": "/v1/auth/sessions/claim",
"url": "https://tokenrobinhood.lat/v1/auth/sessions/claim",
"description": "Bind a paid license key to a pending CLI auth session.",
"side_effect": "write",
"auth": "license_key",
"input_schema": {
"properties": {
"session_id": {
"title": "Session Id",
"type": "string"
},
"license_key": {
"title": "License Key",
"type": "string"
}
},
"required": [
"session_id",
"license_key"
],
"title": "AuthSessionClaimRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
}
},
"required": [
"ok"
]
},
"idempotency": "The same session can only be completed once."
},
{
"id": "poll_cli_auth_session",
"method": "POST",
"path": "/v1/auth/sessions/poll",
"url": "https://tokenrobinhood.lat/v1/auth/sessions/poll",
"description": "Poll whether a CLI auth session is pending, approved, expired, or rejected.",
"side_effect": "none",
"auth": "session_id_and_installation_hash",
"input_schema": {
"properties": {
"session_id": {
"title": "Session Id",
"type": "string"
},
"installation_hash": {
"title": "Installation Hash",
"type": "string"
}
},
"required": [
"session_id",
"installation_hash"
],
"title": "AuthSessionPollRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"status": {
"type": "string"
},
"license_key": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"status"
]
}
},
{
"id": "validate_license",
"method": "POST",
"path": "/v1/licenses/validate",
"url": "https://tokenrobinhood.lat/v1/licenses/validate",
"description": "Validate a license key and record a local installation activation.",
"side_effect": "activation_log",
"auth": "license_key",
"input_schema": {
"properties": {
"license_key": {
"title": "License Key",
"type": "string"
},
"installation_hash": {
"title": "Installation Hash",
"type": "string"
},
"version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Version"
}
},
"required": [
"license_key",
"installation_hash"
],
"title": "ValidateRequest",
"type": "object"
},
"output_schema": {
"type": "object",
"properties": {
"valid": {
"type": "boolean"
},
"plan": {
"type": "string"
},
"email": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"valid"
]
}
},
{
"id": "install_cli",
"method": "GET",
"path": "/install",
"url": "https://tokenrobinhood.lat/install",
"description": "Official bash installer endpoint. Use with TRH_LICENSE_KEY when the user has paid.",
"side_effect": "none",
"auth": "none",
"output": "text/plain shell script"
},
{
"id": "download_python_wheel",
"method": "GET",
"path": "/downloads/token_robin_hood-0.1.4-py3-none-any.whl",
"url": "https://tokenrobinhood.lat/downloads/token_robin_hood-0.1.4-py3-none-any.whl",
"description": "Direct package artifact download when the wheel is present on the server.",
"side_effect": "none",
"auth": "none",
"output": "application/octet-stream"
}
],
"agent_rules": [
"Use official URLs from this descriptor instead of guessing install, support, or purchase flows.",
"Do not describe TRH as a provider-limit bypass.",
"For a paid user, prefer the license-key CLI flow over browser automation.",
"For retries, preserve draft_id/session_id/email where applicable."
]
}