Circlfi MCP server

CirclFi MCP Server

The official Model Context Protocol (MCP) server for CirclFi — the institutional-grade equity valuation platform.

Give any AI assistant direct access to 13 valuation models across 5,900+ US stocks, recalculated daily from SEC EDGAR, FRED, and GDELT data. Intrinsic values, Quality of Company scores (32 fundamental signals), and Value Trap risk scores — as native AI tools.

Two ways to connect

Option A — Remote server (no install, works everywhere)

Point any MCP-compatible client at the hosted endpoint:

https://circlfi.com/mcp

• Transport: Streamable HTTP (stateless), current MCP spec
• Auth: none needed for the free tier. Premium subscribers send their Gumroad purchase email as a bearer token: Authorization: Bearer you@example.com
• Works with ChatGPT connectors (developer mode), Claude custom connectors (web/desktop), agent frameworks, and any cloud client that can't run local processes.

Option B — Local stdio server (npm)

npx -y circlfi-mcp

(Installing from GitHub also works: npx -y github:negm17111995/Circlfi-MCP)

Install in your client

Claude Desktop

Add to claudedesktopconfig.json (macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json, Windows: %APPDATA%\Claude\claudedesktopconfig.json):

{
  "mcpServers": {
    "circlfi": {
      "command": "npx",
      "args": ["-y", "circlfi-mcp"],
      "env": { "CIRCLFI_EMAIL": "" }
    }
  }
}

Restart Claude Desktop and look for the tools icon. Premium subscribers: put your Gumroad purchase email in CIRCLFI_EMAIL.

Claude Code

claude mcp add circlfi -- npx -y circlfi-mcp

Or with premium access:

claude mcp add circlfi -e CIRCLFI_EMAIL=you@example.com -- npx -y circlfi-mcp

Cursor

One-click install →

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "circlfi": { "command": "npx", "args": ["-y", "circlfi-mcp"] }
  }
}

VS Code (Copilot / MCP)

code --add-mcp '{"name":"circlfi","command":"npx","args":["-y","circlfi-mcp"]}'

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "circlfi": { "command": "npx", "args": ["-y", "circlfi-mcp"] }
  }
}

ChatGPT (connectors / developer mode)

ChatGPT connects to remote MCP servers. In Settings → Connectors → Advanced → Developer mode, add a custom connector with the URL:

https://circlfi.com/mcp

Any other MCP client

• Local: command npx, args ["-y", "circlfi-mcp"], optional env CIRCLFI_EMAIL
• Remote: Streamable HTTP at https://circlfi.com/mcp, optional header Authorization: Bearer

Available tools

getstockvaluation

Complete intrinsic valuation profile for any US ticker: fair value, implied upside, and statistical confidence per model, plus the Quality of Company (QOC) score and Value Trap risk score.

Free tier — 3 models, no signup: Bayesian DCF (10,000-run Monte Carlo with jump-diffusion), Earnings Power Value (Greenwald), CUCE Ensemble (meta-model).

Shortened. The full README is on GitHub.