MCP Server

Fundamentals MCP MCP Server

io.github.SimonTarara62/fundamentals-mcp

Repository Registry

What is the Fundamentals MCP MCP server?

Unofficial read-only MCP for fundamentals, macro & news (EDGAR + FRED + Tavily, BYO-key).

How to install Fundamentals MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

FUND_ENV_FILE
Path to a .env file holding FUND_* keys (alternative to inline env).
FUND_EDGAR_USER_AGENT
User-Agent for SEC EDGAR requests; required for resolve_instrument / get_fundamentals.
FUND_FRED_API_KEY
secret
FRED API key; required for get_macro.
FUND_TAVILY_API_KEY
secret
Tavily API key; required for get_news.
FUND_EDGAR_MIN_INTERVAL
Min seconds between EDGAR requests (default 0.2).
FUND_FRED_MIN_INTERVAL
Min seconds between FRED requests (default 0.6).
FUND_TAVILY_MIN_INTERVAL
Min seconds between Tavily requests (default 1.0).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fundamentals-mcp": {
      "command": "uvx",
      "args": [
        "fundamentals-mcp"
      ],
      "env": {
        "FUND_ENV_FILE": "<YOUR_FUND_ENV_FILE>",
        "FUND_EDGAR_USER_AGENT": "<YOUR_FUND_EDGAR_USER_AGENT>",
        "FUND_FRED_API_KEY": "<YOUR_FUND_FRED_API_KEY>",
        "FUND_TAVILY_API_KEY": "<YOUR_FUND_TAVILY_API_KEY>",
        "FUND_EDGAR_MIN_INTERVAL": "<YOUR_FUND_EDGAR_MIN_INTERVAL>",
        "FUND_FRED_MIN_INTERVAL": "<YOUR_FUND_FRED_MIN_INTERVAL>",
        "FUND_TAVILY_MIN_INTERVAL": "<YOUR_FUND_TAVILY_MIN_INTERVAL>"
      }
    }
  }
}