◆ Docs

Build with Almanex

Almanex is a structured equity research index. Read it on the web, or query it from your agent or app.

Bearer-auth REST endpoints with structured JSON responses. List, fetch, and search reports. Per-month rate limits, X-RateLimit-* headers, structured errors.

Read the API docs →

◇ MCP

MCP setup

Drop Almanex into Claude Desktop, Claude Code, or Cursor. One-line install via npx -y almanex-mcp.

MCP setup →

◆ AGENT

Compare tickers

Cross-company structured comparisons sourced from the Almanex corpus. Bring your own Anthropic key, or use ours. Live playground.

Try the agent →

◆ Authentication

All API calls require a Bearer key. Get one at /account. Send it as Authorization: Bearer alm_live_… on every request.

◆ Quick start — HTTP

Pull the latest report for any S&P 500 ticker. Edge-served from Cloudflare with sub-100ms p50 latency.

curl https://almanex.ai/api/v1/reports/AAPL/latest \
  -H "Authorization: Bearer alm_live_xxx…"

◆ Response shape

Every report returns the same canonical shape. Full schema in the API reference.

{
  "ticker": "AAPL",
  "slug": "q2-fy26-earnings",
  "title": "Apple — Q2 FY26 Earnings Update",
  "summary": "Services revenue accelerated to +14% YoY…",
  "sources": [
    { "title": "Apple Q2 FY26 Press Release",
      "url": "https://www.apple.com/newsroom/…",
      "type": "earnings-release" }
  ],
  "body_md": "## Quarter at a glance\n\n…"
}

◆ Quick start — MCP

One-line install. Same corpus, queryable from your agent.

npx -y almanex-mcp

Add the command to your claude_desktop_config.json (Claude Desktop) or run claude mcp add almanex npx -y almanex-mcp (Claude Code). Full setup at /docs/mcp.