Circlfi-MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Circlfi-MCP What is the intrinsic value of AAPL?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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/mcpTransport: 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.comWorks 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)
Related MCP server: Indian Stock Market MCP Server
Install in your client
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.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 mcp add circlfi -- npx -y circlfi-mcpOr with premium access:
claude mcp add circlfi -e CIRCLFI_EMAIL=you@example.com -- npx -y circlfi-mcpOr add to ~/.cursor/mcp.json:
{
"mcpServers": {
"circlfi": { "command": "npx", "args": ["-y", "circlfi-mcp"] }
}
}code --add-mcp '{"name":"circlfi","command":"npx","args":["-y","circlfi-mcp"]}'Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"circlfi": { "command": "npx", "args": ["-y", "circlfi-mcp"] }
}
}ChatGPT connects to remote MCP servers. In Settings → Connectors → Advanced → Developer mode, add a custom connector with the URL:
https://circlfi.com/mcpLocal: command
npx, args["-y", "circlfi-mcp"], optional envCIRCLFI_EMAILRemote: Streamable HTTP at
https://circlfi.com/mcp, optional headerAuthorization: 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.
Available Tools
2 toolsget_market_screenerAInspect
Screen the entire stock market (5,900+ stocks) using CirclFi data. Requires a paid subscription. Can filter by QOC, ValueTrapScore, or Industry. Can return JSON or CSV format.
Inputs: format, filters, fetchAll.
get_stock_valuationAInspect
Get the latest intrinsic valuation of a single stock from CirclFi's 13-model engine. Includes Bayesian DCF, EPV, ML-RIV, etc.
Inputs: ticker (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools serve completely distinct purposes: one focuses on intrinsic valuation of a single stock, while the other screens the entire market. There is no overlap or potential for confusion.
Both tools use a consistent 'get_' prefix followed by a descriptive noun phrase (get_stock_valuation, get_market_screener), following a clear verb_noun pattern.
With only 2 tools, the server feels underpopulated for its stated domain of stock analysis and screening. While the tools are individually valuable, the scope suggests more tools would be reasonable (e.g., price data, fundamentals).
The server only covers valuation and market screening, leaving out essential stock analysis operations like price history, financial statements, or news. This is a significant gap for a stock analysis server.
Maintenance
Related MCP Connectors
Value investing for US stocks: SEC filings, 13F guru holdings, intrinsic value, AI briefings.
Portfolio analytics + US-equity market research for AI clients. ChatGPT deep-research compat.
AI equity research: quant scores, fundamentals, valuation, risks and portfolio audits for any stock.
SEC filings and financial data for AI agents: 59 tools for statements, valuation and supply chains.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides AI assistants with real-time stock prices, financial statements, SEC filings, and analytical tools like DCF valuation and ratio analysis.14-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search, screen, and analyze 8,200+ NSE and BSE listed securities through 55 tools covering live quotes, financials, technical indicators, FII/DII flows, option chains, filings, IPOs, bulk deals, and portfolio P&L.-
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools covering stocks, ETFs, crypto, forex, commodities, and economics.558 npmApache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to access and analyze financial data, stock information, company fundamentals, and market insights through 250+ tools spanning stocks, ETFs, crypto, forex, commodities, economics, and more.558 npmApache 2.0