Developers

Build on Finautor's published market-regime signals — over REST or MCP. Every channel serves the same firewall-safe reading: score, regime label, 20-day direction sign, as-of date, staleness. The methodology is proprietary and never exposed.

Machine-readable discovery

• /openapi.json — OpenAPI 3.1 spec
• /llms.txt — llms.txt (agent overview)
• /.well-known/mcp.json — MCP server card — Signals
• /.well-known/mcp-brain.json — MCP server card — Brain
• /.well-known/api-catalog — API catalog (RFC 9727)
• /.well-known/skills.md — Agent skill instructions

REST API

Four pull-only GET endpoints. No input parameters — each returns today's single published reading or the published series.

• GET /api/signals/v1/regime
  Current Composite Market Regime Score · None — free
• GET /api/signals/v1/history
  Score/regime history, oldest→newest · Optional fsk_ key — 30 days free, up to 5 years subscribed
• GET /api/signals/v1/credit/regime
  Current Credit Stress Regime · None — free
• GET /api/signals/v1/credit/history
  Credit-stress history, oldest→newest · Optional fsk_ key — 30 days free, up to 5 years subscribed

curl https://finautor.com/api/signals/v1/regime

Response shape (illustrative values):

{
  "available": true,
  "score": 52.4,
  "regime": "Mild Risk-On",
  "asOfDate": "2026-07-01",
  "stale": false,
  "direction": "up",
  "disclaimer": "Informational and educational only — …",
  "copyright": "© Finautor — all rights reserved …",
  "_sig": "…"
}

API keys & tiers

Current-score endpoints are free and need no key. Mint an fsk_ key at Settings → Connect your agent (shown once, at creation) and send it as Authorization: Bearer fsk_…. Any active subscription covering a signal unlocks full access to it — the MCP server and up to 5 years of history. See pricing and the connect guide.

MCP server

Streamable HTTP at https://finautor.com/api/signals/mcp — Bearer fsk_ auth, six pull-only tools, zero inputs:

• get_current_score — Latest Composite Market Regime Score
• get_score_history — Published score/regime history
• credit_current_score — Latest Credit Stress Regime
• credit_score_history — Published credit-stress history
• list_signals — The signal catalogue (slug · title · tier)
• get_status — Auth check + data freshness

{
  "mcpServers": {
    "finautor-signals": {
      "type": "http",
      "url": "https://finautor.com/api/signals/mcp",
      "headers": { "Authorization": "Bearer fsk_YOUR_KEY" }
    }
  }
}

Your Brain is the persistent memory Finautor AI compiles from your sessions — markdown pages per ticker, sector, strategy, macro theme and preference, with an audit trail. Streamable HTTP at https://finautor.com/api/brain/mcp — Bearer fsk_ key with a brain:read or brain:write scope (mint at Settings → Connect your Brain). Works with Grok Bot, the xAI API, Claude Desktop / Code, Cursor and any other MCP client; read access is included with every account. Write tools appear only on write-scoped keys, and every external write is audited with a reason and can be undone from the Brain page. Protected-resource metadata: /.well-known/oauth-protected-resource/api/brain/mcp.

• brain_status — Auth check · scopes · page count · read
• search_brain — Full-text search over your pages · read
• read_brain_page — One page, full markdown + metadata · read
• list_brain_pages — Pages by category, staleness, pinned · read
• search / fetch — ChatGPT-connector aliases · read
• create_brain_page — New page (audited, undoable) · write
• update_brain_page — Replace a page's content (audited) · write
• archive_brain_page — Soft-delete, 30-day recovery · write
• pin_brain_page — Protect from consolidation/archive · write
• brain_remember — "Remember this" → filed under the right page · write

{
  "mcpServers": {
    "finautor-brain": {
      "type": "http",
      "url": "https://finautor.com/api/brain/mcp",
      "headers": { "Authorization": "Bearer fsk_YOUR_BRAIN_KEY" }
    }
  }
}

Good citizenship

Readings change at most once per weekday (computed after the U.S. close) — cache for hours, not seconds, and prefer the stale flag over re-polling. Output is informational and educational only — never present a reading as a recommendation to buy or sell anything.