Vintage MCP Server

Name: Vintage MCP Server
Author: io.github.RezaSoleymanifar

io.github.RezaSoleymanifar/vintage

Repository Registry

What is the Vintage MCP server?

Free financial data from eleven sources behind six verbs, point-in-time where the source allows.

How to install Vintage

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

VINTAGE_USER_AGENT
Contact string sent to SEC EDGAR, which asks for a real name and email. Format: 'Your Name your@email.com'.
FRED_API_KEY
secret
Free key from https://fredaccount.stlouisfed.org/apikeys. Unlocks 800k macro series with ALFRED first-release vintages. Everything else works without it.
VINTAGE_CACHE_DIR
Where the gzipped response cache lives. Defaults to ~/.cache/vintage.

Claude Desktop

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

{
  "mcpServers": {
    "vintage": {
      "command": "uvx",
      "args": [
        "vintage-mcp"
      ],
      "env": {
        "VINTAGE_USER_AGENT": "<YOUR_VINTAGE_USER_AGENT>",
        "FRED_API_KEY": "<YOUR_FRED_API_KEY>",
        "VINTAGE_CACHE_DIR": "<YOUR_VINTAGE_CACHE_DIR>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "vintage": {
      "command": "uvx",
      "args": [
        "vintage-mcp"
      ],
      "env": {
        "VINTAGE_USER_AGENT": "<YOUR_VINTAGE_USER_AGENT>",
        "FRED_API_KEY": "<YOUR_FRED_API_KEY>",
        "VINTAGE_CACHE_DIR": "<YOUR_VINTAGE_CACHE_DIR>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "vintage": {
      "command": "uvx",
      "args": [
        "vintage-mcp"
      ],
      "env": {
        "VINTAGE_USER_AGENT": "<YOUR_VINTAGE_USER_AGENT>",
        "FRED_API_KEY": "<YOUR_FRED_API_KEY>",
        "VINTAGE_CACHE_DIR": "<YOUR_VINTAGE_CACHE_DIR>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "vintage": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "vintage-mcp"
      ],
      "env": {
        "VINTAGE_USER_AGENT": "<YOUR_VINTAGE_USER_AGENT>",
        "FRED_API_KEY": "<YOUR_FRED_API_KEY>",
        "VINTAGE_CACHE_DIR": "<YOUR_VINTAGE_CACHE_DIR>"
      }
    }
  }
}

Claude Code

claude mcp add vintage --env VINTAGE_USER_AGENT=<YOUR_VINTAGE_USER_AGENT> --env FRED_API_KEY=<YOUR_FRED_API_KEY> --env VINTAGE_CACHE_DIR=<YOUR_VINTAGE_CACHE_DIR> -- uvx vintage-mcp