HomeChatAlertsCalendarScreenerWatchlistsFiles
DocsSettings
Sign upJoinLog in

Docs

Overview

IntroductionMCP ServerOpenAPI Spec

REST API

WebSocket

Live Quotes (Per Second)Live Quotes (Per Minute)Live NewsLive SEC FilingsTrading Halts

MCP Server

View as markdown

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.

Endpoint
https://mcp.vantafin.com/mcp
Transport
Streamable HTTP (remote)
Authentication
Header Authorization: Bearer YOUR_KEY
Rate limit
1,000 requests per minute per key

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.

ToolDescription
search_companiesResolve a company name, ticker prefix, or CIK to tickers.
get_quotesLive price, % change, volume, day range, market cap and shares for tickers.
get_company_profileSector, industry, country, CEO, employees, website, CIK and description.
get_valuation_metricsMarket cap, P/E, P/S, TTM revenue/EPS and net margin.
get_financialsIncome statement, balance sheet or cash flow (annual or quarterly).
get_revenue_segmentationRevenue broken down by product or geography.
get_etf_holdingsTop constituent holdings and weights for an ETF or fund.
get_price_historySplit-adjusted OHLCV history with a performance summary.
search_filingsSemantic search inside chunked SEC filings (e.g. Risk Factors in a 10-K).
list_filingsList a company's recent SEC filings (metadata).
search_transcriptsSemantic search inside earnings-call transcripts.
get_earningsEarnings results vs estimates (EPS and revenue).
screen_stocksScreen stocks across the full metric set (valuation, financials, margins, growth, technicals, dividends) with comparison operators.
get_newsLatest market or company-specific news.
get_eventsCorporate calendar events (earnings dates, ex-dividend, splits).
get_macroMacro series such as central-bank interest rates.
get_corporate_actionsRecent stock splits and dividends.
get_iposIPO calendar (past + upcoming): date, price range, exchange, disclosures and prospectus pricing.
get_timeCurrent date and time in any timezone.
Introduction
OpenAPI Spec