# 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.

## Endpoint

`https://mcp.vantafin.com/mcp` (Streamable HTTP)

## Authentication

Authenticate with your Vantafin API key via an `Authorization: Bearer YOUR_KEY` header (or `X-API-Key`). The same 1,000 requests/minute rate limit as the REST API applies.

## Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "vantafin": {
      "url": "https://mcp.vantafin.com/mcp",
      "headers": {
        "Authorization": "Bearer vf-live-your_api_key"
      }
    }
  }
}
```

## Claude Code

```bash
claude mcp add --transport http vantafin https://mcp.vantafin.com/mcp \
  --header "Authorization: Bearer vf-live-your_api_key"
```

## Claude Desktop

Claude Desktop connects to remote servers through the `mcp-remote` bridge. Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "vantafin": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.vantafin.com/mcp",
        "--header",
        "Authorization: Bearer vf-live-your_api_key"
      ]
    }
  }
}
```

## Verify

```bash
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

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