godel-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., "@godel-mcp Show me the latest quote for 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.
godel-mcp
A Model Context Protocol server that exposes Godel Terminal-style research as tools for AI clients — describe a security, pull financials, historical prices, analyst ratings, most-active, search, news, and live quotes.
The server is a tool surface over a pluggable data provider. It defines the
tools and the data contract (GodelDataProvider); how the data is fetched is
supplied by whatever provider you inject. It ships with a sample-data provider so
you can run it immediately, and can be embedded with your own.
you ──ask──▶ Claude ──MCP──▶ godel-mcp ──▶ GodelDataProvider (you supply)
│
formats dense, terminal-style panelsTools
Tool | Returns |
| Security overview (name, exchange, last close, CIK/LEI) |
| Delayed last-close snapshot |
| Annual financials + valuation multiples |
| Historical OHLCV bars |
| Analyst rating actions and price targets |
| Most active by dollar volume |
| Instruments / legal entities / news |
| Recent news & filings |
| Real-time quote (needs a live-capable provider) |
Related MCP server: FinClaw
Try it (sample data)
npm install
npm run demo # in-process MCP round-trip printing formatted panels
npm run dev # run the server over stdio with the sample providerEmbed it with your own data
Implement GodelDataProvider and pass it to buildServer / startStdio:
import { startStdio, type GodelDataProvider } from "godel-mcp";
const provider: GodelDataProvider = {
async describe(ticker) { /* ... */ },
async financials(ticker) { /* ... */ },
async liveQuote(ticker) { /* ... */ },
// ...the rest of the interface
};
await startStdio(provider); // serves all tools over stdio, backed by your dataThe data-access layer lives outside this repo by design — this package is just the MCP surface and formatting.
Layout
src/
index.ts entry — runs with the sample provider over stdio
server.ts buildServer(provider)
stdio-run.ts startStdio(provider)
tools.ts MCP tool definitions (call the provider, format results)
provider.ts GodelDataProvider interface + domain types
format.ts dense terminal-style panels
mock-provider.ts sample-data provider
examples/demo.ts in-process MCP demo
test/ formatting + MCP round-tripDevelopment
npm run typecheck
npm test # vitest: formatting + full MCP round-trip against the sample providerLicense
MIT — see LICENSE. Not affiliated with or endorsed by Godel Terminal / DL Software.
Available Tools
9 toolsgodel_describeSecurity descriptionA
Overview for a ticker: name, exchange, instrument type, last close, CIK/LEI.
Inputs: ticker (required).
godel_financialsFinancial statementsA
Standardized annual financials for a ticker (revenue, margins, income, cash flows) plus valuation multiples.
Inputs: ticker (required), periods.
godel_historicalHistorical pricesA
Historical OHLCV bars for a ticker at a given resolution.
Inputs: ticker (required), bars, resolution.
godel_live_quoteLive quote (real-time)A
Real-time quote for a ticker. Requires a provider with live access.
Inputs: ticker (required).
godel_most_activeMost activeC
Most active securities across the market.
Inputs: tab, rows.
godel_newsNews & filingsC
Recent news and filings, optionally filtered to a ticker.
Inputs: limit, ticker.
godel_quoteQuote snapshotB
Delayed last-close snapshot for a ticker (last, volume, dollar volume).
Inputs: ticker (required).
godel_ratingsAnalyst ratingsB
Recent analyst rating actions and price targets for a ticker.
Inputs: ticker (required).
godel_searchSearchC
Search for instruments, legal entities, and news matching a query.
Inputs: query (required), types.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a clearly distinct data type: overview, delayed quote, live quote, financials, historical bars, ratings, market movers, search, and news. The only similar pair is quote vs live_quote, but the delayed/real-time distinction is explicit and unambiguous.
All tool names follow the same pattern: lowercase snake_case with godel_ prefix. The suffix is consistently a noun or verb describing the resource/action (describe, quote, financials, historical, ratings, most_active, search, news, live_quote), forming a predictable set.
With 9 tools, the server is well-scoped for a financial data API. Each tool serves a distinct purpose without redundancy, covering both market-wide queries and individual-instrument data.
The tool surface covers core read-only financial workflows: discovery via search and most_active, then details via describe/quote/financials/historical/ratings/news/live_quote. There are no obvious dead ends or critical missing data types for its purpose.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server exposing the Backtest360 engine API as tools for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that exposes 16 free investment-research signals (insider trades, SEC filings, short data, and live quotes) to any MCP-compatible LLM.88 npm104MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that provides AI agents with financial tools including real-time quotes, backtesting, technical analysis, and multi-exchange data via a simple CLI interface.2MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes stock research tools (fundamentals, news, technicals, analyst ratings) to AI clients, enabling autonomous generation of structured investment briefs.-
- FlicenseNot gradedqualityDmaintenanceProduction-grade MCP server that enables AI assistants to access real-time financial market data with intelligent fallback mechanisms, supporting stock prices, comparisons, fundamentals, and market summaries via Yahoo Finance and CSV.-