circlfi MCP Server

This MCP server provides a “13-model stock valuation engine” for AI agents. It calculates fair values for 5,900+ US stocks and updates valuations daily. The server is distributed as an MCP server for use with the Model Context Protocol (MCP).

🛠️ Key Features

13-model stock valuation engine
Fair value calculations for 5,900+ US stocks
Daily updates to valuations
Topics include: model-context-protocol, mcp, mcp-server

🚀 Use Cases

Stock valuation workflows in AI agents
Supporting Claude-based agent scenarios in finance contexts
Retrieving updated US stock fair value estimates

⚡ Developer Benefits

MCP compatibility for developer integration
Focused finance tooling: stock valuation and fair value outputs
Clearly scoped to US stocks and daily updates

⚠️ Limitations

Coverage described as US stocks only
The valuation method is specified as “13-model,” without further detail on model internals

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:

code

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)

bash

npx -y circlfi-mcp

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

Install in your client

Claude Desktop

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

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

bash

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

Or with premium access:

bash

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

Cursor

One-click install →

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

json

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

VS Code (Copilot / MCP)

bash

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

Windsurf

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

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:

code

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 <gumroad-email>

Available tools

`get_stock_valuation`

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).

Premium — all 13 models: the above plus EROIC Spread, First Chicago, Markov DDM, ML-RIV, Dynamic NAV, PWERM, Regime Cross-Sectional, Sentiment SOTP, FTNN Topology, and RCMH-DCF. Full methodology: circlfi.com/methodology

`get_market_screener` (Premium)

Screen all 5,900+ US stocks in one call. Filter by minimum QOC, maximum Value Trap score, or industry; return JSON for analysis or CSV for download.

Example prompts

"What is the intrinsic value of AAPL according to CirclFi?"
"Screen for Software stocks with QOC above 8 and Value Trap below 10, output as CSV."
"Compare the Bayesian DCF valuations of MSFT and GOOGL and tell me which trades further below fair value."

How it works (security & architecture)

This repository is a thin client — no proprietary algorithms, no API keys. Tool calls are forwarded to the CirclFi API (https://circlfi.com/api/mcp), which verifies premium subscriptions with Gumroad in real time and returns model output. Free-tier requests need no account at all. The hosted remote endpoint (https://circlfi.com/mcp) exposes the identical tools directly over Streamable HTTP.

All output is quantitative model data for educational purposes — not financial advice (disclaimer).

Pricing

Free: 3 models per stock, unlimited tickers
Premium ($39/mo or $299/yr): all 13 models + market screener — subscribe via Gumroad, then use your purchase email as CIRCLFI_EMAIL (local) or bearer token (remote)

Support

Open a GitHub Issue for server problems. For valuation methodology or subscription questions, see circlfi.com.

Circlfi MCP