API and MCP

Everything the app computes is available to your scripts and AI agents: company search, the live Buffett tests and valuation range, and full evidence-quoted analyses. The REST API and the MCP server share one implementation, so they always agree.

Machine-readable: /openapi.json, /pricing.json and /llms.txt.

Authentication

Send a key in the Authorization header. Max plan members create keys in Settings. To try things first, use the public sandbox key rep_sandbox_public: it can read everything public but can't start analyses, and it's limited to 30 requests a minute per IP.

curl https://www.replicly.com/api/v1/companies/KO/snapshot \
  -H "Authorization: Bearer rep_sandbox_public"

Every response is JSON shaped as { data, meta }. meta carries the research disclaimer and a timestamp. Nothing here is personal financial advice, and agents should not present it as such.

MCP server

The hosted server speaks MCP over Streamable HTTP at https://www.replicly.com/api/mcp. Its tools are the operations below, with the same names and inputs. In Claude Code:

claude mcp add --transport http replicly https://www.replicly.com/api/mcp \
  --header "Authorization: Bearer rep_sandbox_public"

Or in any client that takes a JSON config:

{
  "mcpServers": {
    "replicly": {
      "type": "http",
      "url": "https://www.replicly.com/api/mcp",
      "headers": { "Authorization": "Bearer rep_sk_..." }
    }
  }
}

Operations

Running an analysis

A full analysis takes two to four minutes. POST /api/v1/analyses returns a job id straight away; poll GET /api/v1/analyses/{id} until status is succeeded. Send an Idempotency-Key header so a retried request doesn't start, or bill, a second run. Runs count against the key owner's monthly allowance.

curl -X POST https://www.replicly.com/api/v1/analyses \
  -H "Authorization: Bearer rep_sk_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "content-type: application/json" \
  -d '{"ticker":"COST","depth":"standard"}'

Rate limits

Keys get 120 requests a minute; the sandbox gets 30 per IP. Max plans include a monthly call allowance shown in Settings. Over a limit you get a 429 with a Retry-After header.

Errors

Errors share one shape, with a stable code to branch on:

{ "error": { "code": "unknown_company", "message": "No US-listed company found for ZZZZ.", "docs": "https://www.replicly.com/docs/api#errors" } }