# Leeway Financial Data API

> European-first forecast and analytics market data API with MCP support for AI assistants (Cursor, Claude, ChatGPT).

Leeway provides REST and MCP access to financial forecasts, fundamental screening, and historical market capitalization across 70+ exchanges and 100,000+ tickers. The full data API (quotes, fundamentals, dividends, macro, and more) is available to account holders — see the full reference below.

## Product

- Name: Leeway Data API
- Website: https://leeway.tech/data-api
- API base: https://api.leeway.tech/api/v1/public
- OpenAPI: https://api.leeway.tech/openapi.json
- MCP (remote): https://mcp.leeway.tech/mcp
- Auth: OAuth 2.1 (MCP, auto-discovered) or API token via `Authorization: Bearer YOUR_TOKEN` (MCP) or `?apitoken=` (REST)
- Free tier: 50 request units/day after signup
- Paid: 100,000 request units/day

## Coverage

- 70+ exchanges (XETRA, Frankfurt, Euronext, LSE, NYSE, NASDAQ, ...)
- 100,000+ tickers
- Financial forecasts (revenue, net income, EPS)
- Key figures, fundamental screening, relative move, benchmark performance
- Historical market capitalization

## MCP Setup

### Claude, ChatGPT (OAuth)

Add `https://mcp.leeway.tech/mcp` as a custom connector. The client discovers the OAuth endpoints automatically (RFC 9728 protected resource metadata) and opens a Leeway login + consent screen. No manual token handling required.

### Remote (Streamable HTTP) — Cursor, VS Code, most MCP clients

- URL: `https://mcp.leeway.tech/mcp`
- Header: `Authorization: Bearer YOUR_TOKEN`

### Claude Desktop / other stdio-only clients (bridge via mcp-remote)

For clients without OAuth or remote HTTP support, bridge in via the `mcp-remote` npm package instead (runs via `npx`, no Leeway server to install):

```json
{
  "mcpServers": {
    "leeway": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.leeway.tech/mcp", "--header", "Authorization:Bearer YOUR_TOKEN"]
    }
  }
}
```

## Key MCP Tools

- `general_isin` — resolve ISIN or name to symbol/exchange listings
- `general_symbols` — list symbols for an exchange
- `general_screener` — filter stocks by fundamentals
- `fundamentals_forecast` — financial forecasts for SYMBOL.EXCHANGE
- `fundamentals_keyfigures` — calculated metrics as time series
- `historicalquotes_marketcap` — historical market capitalization
- `historicalquotes_benchmark` — performance vs. benchmark indices
- `live_relative-move` — unusual price move detection
- `general_dailyrequestsleft` — remaining daily request units

## Docs

- MCP onboarding: https://leeway.tech/mcp
- MCP setup guide: https://leeway.tech/mcp/setup
- API docs: https://leeway.tech/data-api
- Full tool reference: https://leeway.tech/llms-full.txt
- Account / token: https://leeway.tech/account

## Contact

kontakt@leeway.tech