{"title":"Lithtrix — Agent Quickstart Guide","description":"Follow these steps in order. All calls are HTTPS to the base URL. Your API key from step 2 is used as the Bearer token in all authenticated calls.","base_url":"https://lithtrix.ai","steps":[{"step":1,"name":"discover","description":"Read service capabilities. No auth required. Returns endpoints, rate limits, and credibility scoring rules.","method":"GET","path":"/v1/capabilities","auth_required":false,"params":null,"example_response":{"service":"Lithtrix Search API","version":"1.0.0","authentication":{"type":"bearer","obtain_via":"POST /v1/register"},"rate_limits":{"free_tier":"300 calls (one-time trial, lifetime total)","pro_tier":"unlimited"}}},{"step":2,"name":"register","description":"Register as a new agent and receive a one-time API key. The api_key is shown exactly once — store it immediately. agent_name: letters, digits, hyphens, underscores only.","method":"POST","path":"/v1/register","auth_required":false,"body":{"agent_name":"my-agent","owner_identifier":"you@example.com"},"example_response":{"api_key":"ltx_a3f9b2c1d4e5f6a7b8c9d0e1f2a3b4c5","agent_id":"550e8400-e29b-41d4-a716-446655440000","message":"Store this key securely. It cannot be retrieved again."}},{"step":3,"name":"search","description":"Search the web. Returns credibility-scored results and your remaining quota. calls_remaining in the usage object tells you how many calls are left.","method":"GET","path":"/v1/search","auth_required":true,"auth_header":"Authorization: Bearer ltx_your_api_key","params":{"q":"Singapore climate policy 2025","num_results":5},"example_response":{"status":"success","query":"Singapore climate policy 2025","results":[{"title":"Singapore Green Plan 2030","url":"https://www.greenplan.gov.sg","snippet":"Singapore's whole-of-nation movement...","source":"www.greenplan.gov.sg","credibility_score":1.0,"published_date":null}],"usage":{"calls_total":1,"calls_remaining":299,"over_limit":false,"upgrade_url":"/v1/billing/setup"},"cached":false,"response_time_ms":312}},{"step":4,"name":"check_usage","description":"Check your current tier, lifetime call count, and remaining quota. over_limit: true means you must upgrade to continue searching.","method":"GET","path":"/v1/billing","auth_required":true,"auth_header":"Authorization: Bearer ltx_your_api_key","params":null,"example_response":{"tier":"free","calls_total":1,"call_limit":300,"over_limit":false,"stripe_customer_id":null}},{"step":5,"name":"upgrade","description":"Upgrade to Pro tier for unlimited calls. First fetch the Stripe publishable key from GET /v1/billing/config, then create a PaymentMethod using the Stripe API, then POST the pm_... token here.","method":"POST","path":"/v1/billing/setup","auth_required":true,"auth_header":"Authorization: Bearer ltx_your_api_key","prereq":"GET /v1/billing/config → stripe_publishable_key → create Stripe PaymentMethod → pm_...","body":{"payment_method_id":"pm_card_visa"},"example_response":{"tier":"pro","stripe_customer_id":"cus_abc123","message":"Billing setup complete. Your account is now Pro tier."}}],"errors":{"description":"All errors use a consistent envelope.","shape":{"status":"error","error_code":"MACHINE_READABLE_CODE","message":"Human-readable description."},"common_codes":{"INVALID_API_KEY":"Bearer token missing or not recognised.","RATE_LIMIT_EXCEEDED":"Per-minute rate limit hit. See Retry-After header.","OVER_LIMIT":"Lifetime call limit reached. Upgrade to Pro.","AGENT_ALREADY_EXISTS":"agent_name + owner_identifier pair already registered."}},"mcp":{"description":"Use the MCP server to access Lithtrix from Claude or any MCP client.","install":"npx -y lithtrix-mcp","tools":["lithtrix_search","lithtrix_register"],"credential":"Set LITHTRIX_API_KEY environment variable."}}