English Français العربية

Fundamentals MCP

Official registry Finance and payments

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

Source code Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package fundamentals-mcp
Claude Code 
claude mcp add fundamentals-mcp -e 'FUND_ENV_FILE=<FUND_ENV_FILE>' -e 'FUND_EDGAR_USER_AGENT=<FUND_EDGAR_USER_AGENT>' -e 'FUND_FRED_API_KEY=<your fund_fred_api_key>' -e 'FUND_TAVILY_API_KEY=<your fund_tavily_api_key>' -e 'FUND_EDGAR_MIN_INTERVAL=<FUND_EDGAR_MIN_INTERVAL>' -e 'FUND_FRED_MIN_INTERVAL=<FUND_FRED_MIN_INTERVAL>' -e 'FUND_TAVILY_MIN_INTERVAL=<FUND_TAVILY_MIN_INTERVAL>' -- uvx fundamentals-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fundamentals-mcp": {
            "command": "uvx",
            "args": [
                "fundamentals-mcp==0.1.1"
            ],
            "env": {
                "FUND_ENV_FILE": "<FUND_ENV_FILE>",
                "FUND_EDGAR_USER_AGENT": "<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": "<FUND_EDGAR_MIN_INTERVAL>",
                "FUND_FRED_MIN_INTERVAL": "<FUND_FRED_MIN_INTERVAL>",
                "FUND_TAVILY_MIN_INTERVAL": "<FUND_TAVILY_MIN_INTERVAL>"
            }
        }
    }
}

Environment variables

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

Frequently asked questions

What is Fundamentals MCP?

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

How do I install Fundamentals MCP?

It runs on your machine. In Claude Code: claude mcp add fundamentals-mcp -e 'FUND_ENV_FILE=<FUND_ENV_FILE>' -e 'FUND_EDGAR_USER_AGENT=<FUND_EDGAR_USER_AGENT>' -e 'FUND_FRED_API_KEY=<your fund_fred_api_key>' -e 'FUND_TAVILY_API_KEY=<your fund_tavily_api_key>' -e 'FUND_EDGAR_MIN_INTERVAL=<FUND_EDGAR_MIN_INTERVAL>' -e 'FUND_FRED_MIN_INTERVAL=<FUND_FRED_MIN_INTERVAL>' -e 'FUND_TAVILY_MIN_INTERVAL=<FUND_TAVILY_MIN_INTERVAL>' -- uvx fundamentals-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Fundamentals MCP need an API key?

Yes. It expects FUND_FRED_API_KEY, FUND_TAVILY_API_KEY, which you set in its configuration.

Is Fundamentals MCP open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Fundamentals MCP?

It is published by SimonTarara62. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.