Recommended route

ChatGPT, Claude, Gemini & Perplexity (OAuth)

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.

Which client do you want to connect?

Choose the assistant in which the Leeway tools should appear. The next steps depend on that client and on its plan.

Claude Desktop

Claude Desktop connects through a local stdio bridge (mcp-remote) and an API token. This setup is separate from the OAuth connectors on the Claude website. You do not need to install or host a Leeway server for it.

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

Make sure Node.js is installed (needed for npx; nothing else to install).
In Claude Desktop, open Settings → Developer → Edit Config.
Paste the block below and replace YOUR_TOKEN with your Leeway API token.
Before you use the client, top up your wallet or book an API package for market data.
Restart Claude Desktop, and the tools are ready in your conversation.

Config file: claude_desktop_config.json

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

For other clients: use an API token

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.

Register for free

Then follow the instructions below.

Further clients and developer setups

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.

Custom GPTs & assistants (OpenAPI / REST)OpenAPI / REST

Assistants that don't support MCP can be connected using our OpenAPI specification. You provide the JSON schema and authenticate via a query parameter.

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

REST base URLhttps://api.leeway.tech

Authentication (query parameter)?apitoken=YOUR_TOKEN

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

Full schema (all endpoints)https://api.leeway.tech/openapi.json

Context APIhttps://api.leeway.tech/openapi-context-api.json

Data API (all)https://api.leeway.tech/openapi-data-api.json

Data API – Price Datahttps://api.leeway.tech/openapi-data-api-price-data.json

Data API – Fundamental Datahttps://api.leeway.tech/openapi-data-api-fundamental-data.json

Data API – General, Macro, Bonds & Newshttps://api.leeway.tech/openapi-data-api-rest.json

Analytics APIhttps://api.leeway.tech/openapi-analytics-api.json

Forecast APIhttps://api.leeway.tech/openapi-forecast-api.json

Pick a schema URL below (use a smaller one if your tool rejects the full schema), open it in your browser, select all, and copy the JSON text.
Create a new action or skill in your AI assistant and paste the copied JSON text into the 'Schema' field.
Set the authentication type to 'API Key' (passed as a Query parameter). The parameter name is 'apitoken' and the value is your Leeway token.
Before you use the client, top up your wallet or book an API package for market data.
Save the configuration and repeat for any additional schemas you need. The endpoints will now be available as actions.

Cursor (Remote MCP)Remote MCP (HTTP)

Cursor connects remotely over Streamable HTTP. The fastest path is the one-click install; alternatively add the server to mcp.json manually.

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

Add to Cursor

Click "Add to Cursor" or copy the config below.
Open ~/.cursor/mcp.json and add the block under mcpServers.
Replace YOUR_TOKEN with your Leeway API token.
Before you use the client, top up your wallet or book an API package for market data.
In Cursor settings under MCP, refresh the server, and the Leeway tools show up in chat.

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop (stdio)Local bridge (stdio)

Claude Desktop connects through a local stdio bridge (mcp-remote) and an API token. This setup is separate from the OAuth connectors on the Claude website. You do not need to install or host a Leeway server for it.

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

Make sure Node.js is installed (needed for npx; nothing else to install).
In Claude Desktop, open Settings → Developer → Edit Config.
Paste the block below and replace YOUR_TOKEN with your Leeway API token.
Before you use the client, top up your wallet or book an API package for market data.
Restart Claude Desktop, and the tools are ready in your conversation.

Config file: claude_desktop_config.json

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

VS Code (Remote MCP)Remote MCP (HTTP)

VS Code (with an MCP-capable extension) connects remotely over Streamable HTTP, the same config as Cursor.

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

Install an MCP-capable extension and open its MCP configuration.
Add the server block below and replace YOUR_TOKEN.
Before you use the client, top up your wallet or book an API package for market data.
Reload the extension, and the tools become available.

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Other MCP clients (Remote MCP)Other clients

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

Find your API token in the account area. Copy it and replace YOUR_TOKEN below.

Endpointhttps://mcp.leeway.tech/mcp

Auth headerAuthorization: Bearer YOUR_TOKEN

Before you use the client, top up your wallet or book an API package for market data.

Note: opening the MCP endpoint directly in a browser returns an auth error, which is expected. It's only used by the MCP client with your token.

Available tools

Every public endpoint is exposed automatically as an MCP tool, so your client sees the whole catalogue once the connection stands.

Specification of available Model Context Protocol tools.
Tool identifier	Category	Parameters	Return payload & capability
`ai_whatsnew`	AI Context	`symbol.exchange, [lang, maxAgeDays, sources]`	Current developments for a stock with analysis. Context is served from the shared cache or generated when needed. Sources only when sources=true.
`ai_research_timeline`	AI Context	`symbol.exchange, [lang, maxAgeDays, sources]`	Five-year timeline with important events and investor sentiment.
`ai_research_competitors`	AI Context	`symbol.exchange, [lang, maxAgeDays, sources]`	Structured overview of competitors and the company’s position.
`ai_research_risks`	AI Context	`symbol.exchange, [lang, maxAgeDays, sources]`	Current key risks for a company and its stock. Sources only when sources=true.
`ai_research_price-drivers`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	The most important factors currently driving a stock’s price.
`ai_research_industry`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	Current developments in the company’s industry.
`ai_research_sector`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	Current developments in the company’s sector.
`ai_asset_whatsnew`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	Current developments for a tradable asset such as a commodity or currency.
`ai_asset_timeline`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	Multi-year timeline for a tradable asset.
`ai_asset_price-drivers`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	The most important factors driving an asset’s price.
`ai_asset_events`	AI Context	`symbol.exchange, [maxAgeDays, sources]`	Relevant current events for a tradable asset.
`ai_market_weekly`	AI Context	`length, lang, [sources]`	Weekly market briefing. Included for every account, with no wallet charge. short is the email text, long is the full website article.
`ai_market_daily`	AI Context	`length, lang, [sources]`	Daily market briefing. Requires a trader subscription, with no wallet charge. short and long return the same article, because the email sends that website text.
`ai_market_cio-view`	AI Context	`length, lang, [sources]`	CIO view. Included for investor and trader subscriptions, with no wallet charge. short is the email, long is the full website CIO view.
`ai_market_timeline-weekly`	AI Context	`[lang, maxAgeDays, sources]`	Weekly timeline of the most important market developments from the shared cache.
`ai_market_topics`	AI Context	`cadence, topic, [maxAgeDays, sources]`	One research topic from the daily or weekly market briefing.
`fundamentals`	Fundamentals	`symbol, [lang], [fmt], [mainexchange]`	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.

Troubleshooting

No tools appear.

Check that the server is enabled and refreshed in the client. After editing the config, a restart or refresh is usually required.

401 / Unauthorized.

YOUR_TOKEN was not replaced, or the token is invalid. Get a fresh token in the account area.

Rate limit reached.

The free tier includes 50 request units per day. For production use, the Data API plan offers 100,000 per day.

Connect Leeway MCP to your client

ChatGPT, Claude, Gemini & Perplexity (OAuth)

Which client do you want to connect?

Which ChatGPT plan do you use?

Where do you open Claude?

Does your Gemini account meet the requirements?

Which Perplexity plan do you use?

ChatGPT Free

ChatGPT Plus, Pro and Team

ChatGPT Business

ChatGPT Enterprise and Edu

Claude on the website

Claude Desktop

Claude in the mobile app

Gemini Spark in the United States

Gemini without Spark or outside the United States

Perplexity Free

Perplexity Pro, Max and Enterprise

For other clients: use an API token

Further clients and developer setups

Available tools

Troubleshooting

Related topics

Context API

Shared cache

Ready to start?