The easiest way is ChatGPT, Claude, Gemini or Perplexity: add Leeway, sign in, and start asking questions. Other connection options are available below.
ChatGPT, Claude, Gemini and Perplexity connect to your Leeway account via OAuth. You only add the server URL; sign-in and consent happen in the browser. No API token to copy; internally your existing token and quota are used.
First create a free Leeway account.
Create a free accountThen open the add-connector dialog in the client you use.
Paste the following server URL and confirm.
https://mcp.leeway.tech/mcpA Leeway login opens. Sign in and allow access.
Back in the client, the Leeway tools are ready.
Cursor, VS Code, Claude Desktop with the local bridge, OpenAPI clients and other clients need an API token. Create a free account and copy the token from your account area.
Custom GPTs, Cursor, Claude Desktop, VS Code and every other MCP client connect with an API token. Open the section for your client to see the full instructions including the configuration.
Assistants that don't support MCP can be connected using our OpenAPI specification. You provide the JSON schema and authenticate via a query parameter.
https://api.leeway.tech?apitoken=YOUR_TOKENEach schema below covers one product family. The full schema is too large for some importers, so add the smaller ones as separate skills or actions instead; together they still cover every endpoint.
https://api.leeway.tech/openapi.jsonhttps://api.leeway.tech/openapi-data-api.jsonhttps://api.leeway.tech/openapi-data-api-price-data.jsonhttps://api.leeway.tech/openapi-data-api-fundamental-data.jsonhttps://api.leeway.tech/openapi-data-api-rest.jsonhttps://api.leeway.tech/openapi-analytics-api.jsonhttps://api.leeway.tech/openapi-forecast-api.jsonCursor connects remotely over Streamable HTTP. The fastest path is the one-click install; alternatively add the server to mcp.json manually.
{
"mcpServers": {
"leeway-api": {
"url": "https://mcp.leeway.tech/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Claude Desktop connects through a local stdio bridge (mcp-remote) and an API token. This keeps the desktop setup separate from the browser-based OAuth connectors above, with no Leeway server to install or host yourself.
{
"mcpServers": {
"leeway": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.leeway.tech/mcp",
"--header",
"Authorization:Bearer YOUR_TOKEN"
]
}
}
}VS Code (with an MCP-capable extension) connects remotely over Streamable HTTP, the same config as Cursor.
{
"mcpServers": {
"leeway-api": {
"url": "https://mcp.leeway.tech/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Any MCP-compatible client connects with the same two pieces: the endpoint and the Authorization header. The endpoint is meant for MCP clients, not for opening in a browser (there you only get an auth message).
https://mcp.leeway.tech/mcpAuthorization: Bearer YOUR_TOKENEvery public endpoint is exposed automatically as an MCP tool, so your client sees the whole catalogue once the connection stands.
| Tool identifier | Category | Parameters | Return payload & capability |
|---|---|---|---|
ai_whatsnew | AI Context | symbol.exchange, [lang, maxAgeDays] | Current developments for a stock with sources and analysis. Context is served from the shared cache or generated when needed. |
ai_research_timeline | AI Context | symbol.exchange, [lang, maxAgeDays] | Five-year timeline with important events and investor sentiment. |
ai_research_competitors | AI Context | symbol.exchange, [lang, maxAgeDays] | Structured overview of competitors and the company’s position. |
ai_research_risks | AI Context | symbol.exchange, [lang, maxAgeDays] | Current key risks for a company and its stock with sources. |
ai_research_price-drivers | AI Context | symbol.exchange, [maxAgeDays] | The most important factors currently driving a stock’s price. |
ai_research_industry | AI Context | symbol.exchange, [maxAgeDays] | Current developments in the company’s industry. |
ai_research_sector | AI Context | symbol.exchange, [maxAgeDays] | Current developments in the company’s sector. |
ai_asset_whatsnew | AI Context | symbol.exchange, [maxAgeDays] | Current developments for a tradable asset such as a commodity or currency. |
ai_asset_timeline | AI Context | symbol.exchange, [maxAgeDays] | Multi-year timeline for a tradable asset. |
ai_asset_price-drivers | AI Context | symbol.exchange, [maxAgeDays] | The most important factors driving an asset’s price. |
ai_asset_events | AI Context | symbol.exchange, [maxAgeDays] | Relevant current events for a tradable asset. |
ai_market_today | AI Context | [lang, maxAgeDays] | Current daily market briefing from the shared cache. |
ai_market_weekly | AI Context | [maxAgeDays] | Weekly market briefing from the shared cache. |
ai_market_timeline-weekly | AI Context | [lang, maxAgeDays] | Weekly timeline of the most important market developments from the shared cache. |
fundamentals | Fundamentals | symbol, [period] | Comprehensive balance sheet, income statement, and cash flow history for up to 40 years. |
fundamentals_forecast | Fundamentals | symbol | Revenue and earnings estimates, consensus forecasts, and calculated PE expectations. |
fundamentals_keyfigures | Fundamentals | symbol | Key figures including return on equity, return on capital employed, and operating margins. |
live | Market Data | symbol | Real-time quote snapshot with bid, ask, last price, and trading volume. |
live_relative-move | Market Data | symbol | Relative price changes, intraday volatility, and Average True Range (ATR) metrics. |
dividends | Market Data | symbol, [from] | Historical cash dividends, dividend payment dates, ex-dates, and payout ratios. |
dividends_history | Market Data | symbol | Daily dividend-yield OHLC series derived from payouts and price. A zero value means that no dividend is active for that trading day. |
splits | Market Data | symbol | Historical stock splits with split ratios and effective execution dates. |
intraday | Market Data | symbol, interval | High-resolution intraday bars in 1-minute, 5-minute, or 1-hour intervals. |
historicalquotes | Historical Quotes | symbol, [from, to] | Daily historical price series with open, high, low, close, and volume. |
historicalquotes_marketwide-lastday-quote | Historical Quotes | exchange, [date] | Market-wide end-of-day closing prices across all instruments on an exchange. |
historicalquotes_marketcap | Historical Quotes | symbol, [from, to] | Historical market capitalization and valuation metrics over time. |
historicalquotes_marketcap_aggregation | Historical Quotes | sector, [from, to] | Aggregated market capitalization by sector and industry groups. |
historicalquotes_benchmark | Historical Quotes | symbol, benchmark, [period] | Relative performance of an equity compared to major benchmark indices. |
general_screener | General | filters, [sort, limit] | Stock screener across 70+ exchanges based on fundamental ratios and performance. |
general_isin | General | isin | Resolves ticker symbols, security names, and exchanges using an ISIN. |
general_mainstock | General | isin | Primary listing and main trading venue for a multi-listed company. |
general_symbols | General | query | Full-text search for instruments using symbol prefix or company name. |
general_exchanges | General | [code] | List of supported international stock exchanges and trading calendars. |
general_tradingperiod | General | exchange | Valid trading hours and timezone metadata for a specified exchange. |
general_dailyrequestsleft | General | none | Remaining daily request units available on the active API token. |
general_credits | General | none | Current wallet balance with included and purchased units. |
events_earnings | Events & Macro | [symbol, from, to] | Scheduled quarterly and annual earnings announcement dates and report history. |
events_ipos | Events & Macro | [from, to] | Upcoming and historical initial public offerings with issue price and exchange. |
events_trends | Events & Macro | symbol | Analyst consensus trends, rating distributions, and recommendation changes. |
events_splits | Events & Macro | [from, to] | Corporate actions calendar for scheduled stock splits. |
macro_indicators | Events & Macro | indicator, country | Macroeconomic indicator series such as inflation rates, GDP growth, and unemployment. |
macro_countries | Events & Macro | none | Country codes and covered national economies for macroeconomic datasets. |
macro | Events & Macro | country, indicator | Core macroeconomic timeseries across historical periods. |
bond | Events & Macro | country, maturity | Yield curve data and benchmark yields for government and corporate bonds. |
news | Events & Macro | symbol, [limit] | Curated financial news feeds tagged by ticker and industry sector. |
img_logos | Images | symbol | Official company logo brand assets in vector (SVG) or raster formats. |
img_logosbycodeexchange | Images | code, exchange | Company logos resolved by stock symbol and exchange code. |
ratings | Ratings | symbol.exchange | Leeway scores for Market-Fit, Business, Cycle and Leeway, plus Market-Fit factor statistics. |
Check that the server is enabled and refreshed in the client. After editing the config, a restart or refresh is usually required.
YOUR_TOKEN was not replaced, or the token is invalid. Get a fresh token in the account area.
The free tier includes 50 request units per day. For production use, the Data API plan offers 100,000 per day.
Explore how structured research briefs and shared caching complement the market data tools of the MCP server.
Add Leeway to ChatGPT, Claude, Gemini or Perplexity and start asking questions with current market data.