Vintage MCP server
io.github.RezaSoleymanifar/vintage·v0.9.0·1 starsFree financial data from eleven sources behind six verbs, point-in-time where the source allows.
1 stars
Reviews
Write oneNobody has reviewed Vintage yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Vintage tools (7, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
backtestwrite actionRun a cross-sectional backtest. Point-in-time and costed by construction.
benchmarkScore a backtest against the published Fama-French factors.
discoverSearch every source's catalog for fields matching a plain-English query.
eventsTimeline of what happened to an entity, with exact public timestamps.
fetchFetch any field from any source, as point-in-time rows.
resolveTurn any identifier into the entity key every other verb accepts.
statusCache size, configured keys, sources available, and specs tried so far.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan39 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Vintage compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 7
- the typical server has 7
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
What its tools let an agent do: 6 read · 1 change
Install Vintage in Claude Code, Cursor or VS Code
claude mcp add vintage -- uvx vintage-mcp
What the publisher says
From the Vintage repository's README, as published. We do not edit it. Read it on GitHub
Free financial data exists and is scattered across twenty APIs with twenty shapes. Everyone rebuilds the same glue, badly, and quietly ends up backtesting on restated figures and survivor biased universes.
Vintage is that glue, written once, served over MCP. It hosts no data. It connects, normalizes, and serves structured financial data from the web.
A research terminal that costs $0 and won't lie to you about your Sharpe.
rezasoleymanifar.github.io/vintage
What people use it for
Two of four scenes — see the full reel on the site.
Install
Claude Code
claude mcp add vintage -s user -- uvx vintage-mcpClaude Desktop / any MCP client — add to your config file:
{
"mcpServers": {
"vintage": {
"command": "uvx",
"args": ["vintage-mcp"]
}
}
}Claude Desktop config lives at %APPDATA%\Claude\claudedesktopconfig.json (Windows) or ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS). Restart the app afterwards. MCP servers load once at startup.
Needs uv. If you'd rather use pip: pip install vintage-mcp and set the command to vintage.
Optional configuration
Everything works with zero configuration. These make it work better:
Set them under "env" in the same config block:
{
"mcpServers": {
"vintage": {
"command": "uvx",
"args": ["vintage-mcp"],
"env": {
"VINTAGE_USER_AGENT": "Jane Quant jane@example.com",
"FRED_API_KEY": "..."
}
}
}
}Your key stays in this file. It is read by the server process and is never passed through the model or written into the conversation.
Use it as a library
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Vintage: common questions
- Is Vintage MCP server safe?
- Mostly: it is graded B (83/100). Read the Vintage safety report
- How do I install Vintage?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Vintage need an API key?
- Yes. The registry entry asks for
FRED_API_KEY. - Is Vintage maintained?
- The last commit was 41 days ago (2026-09-24). The latest release is v0.9.0.
- How does Vintage compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.