MCP Server

Fundamentals MCP MCP Server

Name: Fundamentals MCP MCP Server
Author: io.github.SimonTarara62

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

Claude Desktop

~/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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "fundamentals-mcp": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add fundamentals-mcp --env FUND_ENV_FILE=<YOUR_FUND_ENV_FILE> --env FUND_EDGAR_USER_AGENT=<YOUR_FUND_EDGAR_USER_AGENT> --env FUND_FRED_API_KEY=<YOUR_FUND_FRED_API_KEY> --env FUND_TAVILY_API_KEY=<YOUR_FUND_TAVILY_API_KEY> --env FUND_EDGAR_MIN_INTERVAL=<YOUR_FUND_EDGAR_MIN_INTERVAL> --env FUND_FRED_MIN_INTERVAL=<YOUR_FUND_FRED_MIN_INTERVAL> --env FUND_TAVILY_MIN_INTERVAL=<YOUR_FUND_TAVILY_MIN_INTERVAL> -- uvx fundamentals-mcp

Related MCP servers

Capital.com MCP Server

Active

Unofficial community MCP for the Capital.com Open API. Guarded two-phase trades; demo-first.

Python

Apache-2.0

View repository →