Skip to main content
Glama
godel-mcp

godel-mcp

by gwarren3210

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 panels

Tools

Tool

Returns

godel_describe

Security overview (name, exchange, last close, CIK/LEI)

godel_quote

Delayed last-close snapshot

godel_financials

Annual financials + valuation multiples

godel_historical

Historical OHLCV bars

godel_ratings

Analyst rating actions and price targets

godel_most_active

Most active by dollar volume

godel_search

Instruments / legal entities / news

godel_news

Recent news & filings

godel_live_quote

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 provider

Embed 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 data

The 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-trip

Development

npm run typecheck
npm test           # vitest: formatting + full MCP round-trip against the sample provider

License

MIT — see LICENSE. Not affiliated with or endorsed by Godel Terminal / DL Software.

Available Tools

9 tools
godel_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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that exposes 16 free investment-research signals (insider trades, SEC filings, short data, and live quotes) to any MCP-compatible LLM.
      88 npm
      104
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that provides AI agents with financial tools including real-time quotes, backtesting, technical analysis, and multi-exchange data via a simple CLI interface.
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes stock research tools (fundamentals, news, technicals, analyst ratings) to AI clients, enabling autonomous generation of structured investment briefs.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Production-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.
      -