MCP Server
Connect Vantafin to AI tools that speak the Model Context Protocol (MCP) - such as Claude, Claude Code and Cursor - so they can query Vantafin data directly: live quotes, fundamentals, SEC filings, earnings transcripts, screeners, macro data and more. The server uses the same fast data layer that powers Vantafin chat, so answers are accurate and grounded in the underlying filings and figures.
Cursor
Add the server to ~/.cursor/mcp.json (or a project .cursor/mcp.json), then enable it in Settings → MCP.
{
"mcpServers": {
"vantafin": {
"url": "https://mcp.vantafin.com/mcp",
"headers": {
"Authorization": "Bearer vf-live-your_api_key"
}
}
}
}Claude Code
Register the remote server from your terminal:
claude mcp add --transport http vantafin https://mcp.vantafin.com/mcp \
--header "Authorization: Bearer vf-live-your_api_key"Claude Desktop
Claude Desktop reaches remote servers through the mcp-remote bridge. Add this to your claude_desktop_config.json and restart Claude.
{
"mcpServers": {
"vantafin": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.vantafin.com/mcp",
"--header",
"Authorization: Bearer vf-live-your_api_key"
]
}
}
}Verify the connection
List the available tools with a raw request:
curl -X POST https://mcp.vantafin.com/mcp \
-H "Authorization: Bearer vf-live-your_api_key" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Available tools
The AI client picks the right tool automatically based on your question.
| Tool | Description |
|---|---|
| search_companies | Resolve a company name, ticker prefix, or CIK to tickers. |
| get_quotes | Live price, % change, volume, day range, market cap and shares for tickers. |
| get_company_profile | Sector, industry, country, CEO, employees, website, CIK and description. |
| get_valuation_metrics | Market cap, P/E, P/S, TTM revenue/EPS and net margin. |
| get_financials | Income statement, balance sheet or cash flow (annual or quarterly). |
| get_revenue_segmentation | Revenue broken down by product or geography. |
| get_etf_holdings | Top constituent holdings and weights for an ETF or fund. |
| get_price_history | Split-adjusted OHLCV history with a performance summary. |
| search_filings | Semantic search inside chunked SEC filings (e.g. Risk Factors in a 10-K). |
| list_filings | List a company's recent SEC filings (metadata). |
| search_transcripts | Semantic search inside earnings-call transcripts. |
| get_earnings | Earnings results vs estimates (EPS and revenue). |
| screen_stocks | Screen stocks across the full metric set (valuation, financials, margins, growth, technicals, dividends) with comparison operators. |
| get_news | Latest market or company-specific news. |
| get_events | Corporate calendar events (earnings dates, ex-dividend, splits). |
| get_macro | Macro series such as central-bank interest rates. |
| get_corporate_actions | Recent stock splits and dividends. |
| get_ipos | IPO calendar (past + upcoming): date, price range, exchange, disclosures and prospectus pricing. |
| get_time | Current date and time in any timezone. |