Setup · Step by step

Connect Leeway MCP to your client

The easiest way is ChatGPT, Claude, Gemini or Perplexity: add Leeway, sign in, and start asking questions. Other connection options are available below.

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.

  1. First create a free Leeway account.

    Create a free account
  2. Then open the add-connector dialog in the client you use.

    ClaudeSettings → Connectors → Add custom connectorMore detailsAvailable only in the browser or desktop app, not in the mobile app.
    ChatGPTSettings → Apps → CreateMore details

    Custom MCP apps are available on ChatGPT web; access depends on your plan and workspace permissions.

    Access

    • Business admins or owners create the app under Workspace settings → Apps → Create.
    • Enterprise/Edu users need access under Workspace settings → Permissions & Roles → Connected Data and then enable Developer mode under Settings → Apps → Advanced Settings.
    • Other eligible users enable Developer mode under Settings → Apps → Advanced Settings.

    Setup

    1. Open Settings → Apps → Create, enter the Leeway MCP URL, choose OAuth, and click Scan Tools.
    2. Complete the Leeway login and consent prompt, wait for tool scanning to finish, and create the app.
    3. In a new chat, open the tools menu and select the app. Custom MCP apps are available on the web, not in the mobile app.
    GeminiGemini web app → Settings & help → Connected Apps → Custom apps for Spark → Add a custom appMore detailsCustom apps currently require Gemini Spark, an eligible personal Google account in the US, and Keep Activity enabled.
    PerplexityAccount settings → Connectors → + Custom connector → RemoteMore detailsEnter the MCP URL, choose Streamable HTTP, select OAuth, leave client credentials empty for automatic registration, then add and enable the connector.
  3. Paste the following server URL and confirm.

    Endpointhttps://mcp.leeway.tech/mcp
  4. A Leeway login opens. Sign in and allow access.

  5. Back in the client, the Leeway tools are ready.

You'll be taken to a Leeway consent page. If you're not signed in yet, you'll be sent to the login first.

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.

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
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
  1. 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.
  2. Create a new action or skill in your AI assistant and paste the copied JSON text into the 'Schema' field.
  3. Set the authentication type to 'API Key' (passed as a Query parameter). The parameter name is 'apitoken' and the value is your Leeway token.
  4. 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
  1. Click "Add to Cursor" or copy the config below.
  2. Open ~/.cursor/mcp.json and add the block under mcpServers.
  3. Replace YOUR_TOKEN with your Leeway API token.
  4. 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 keeps the desktop setup separate from the browser-based OAuth connectors above, with no Leeway server to install or host yourself.

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

  1. Make sure Node.js is installed (needed for npx; nothing else to install).
  2. In Claude Desktop, open Settings → Developer → Edit Config.
  3. Paste the block below and replace YOUR_TOKEN with your Leeway API token.
  4. 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.

  1. Install an MCP-capable extension and open its MCP configuration.
  2. Add the server block below and replace YOUR_TOKEN.
  3. 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

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 identifierCategoryParametersReturn payload & capability
ai_whatsnewAI Contextsymbol.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_timelineAI Contextsymbol.exchange, [lang, maxAgeDays] Five-year timeline with important events and investor sentiment.
ai_research_competitorsAI Contextsymbol.exchange, [lang, maxAgeDays] Structured overview of competitors and the company’s position.
ai_research_risksAI Contextsymbol.exchange, [lang, maxAgeDays] Current key risks for a company and its stock with sources.
ai_research_price-driversAI Contextsymbol.exchange, [maxAgeDays] The most important factors currently driving a stock’s price.
ai_research_industryAI Contextsymbol.exchange, [maxAgeDays] Current developments in the company’s industry.
ai_research_sectorAI Contextsymbol.exchange, [maxAgeDays] Current developments in the company’s sector.
ai_asset_whatsnewAI Contextsymbol.exchange, [maxAgeDays] Current developments for a tradable asset such as a commodity or currency.
ai_asset_timelineAI Contextsymbol.exchange, [maxAgeDays] Multi-year timeline for a tradable asset.
ai_asset_price-driversAI Contextsymbol.exchange, [maxAgeDays] The most important factors driving an asset’s price.
ai_asset_eventsAI Contextsymbol.exchange, [maxAgeDays] Relevant current events for a tradable asset.
ai_market_todayAI Context[lang, maxAgeDays] Current daily market briefing from the shared cache.
ai_market_weeklyAI Context[maxAgeDays] Weekly market briefing from the shared cache.
ai_market_timeline-weeklyAI Context[lang, maxAgeDays] Weekly timeline of the most important market developments from the shared cache.
fundamentalsFundamentalssymbol, [period] Comprehensive balance sheet, income statement, and cash flow history for up to 40 years.
fundamentals_forecastFundamentalssymbol Revenue and earnings estimates, consensus forecasts, and calculated PE expectations.
fundamentals_keyfiguresFundamentalssymbol Key figures including return on equity, return on capital employed, and operating margins.
liveMarket Datasymbol Real-time quote snapshot with bid, ask, last price, and trading volume.
live_relative-moveMarket Datasymbol Relative price changes, intraday volatility, and Average True Range (ATR) metrics.
dividendsMarket Datasymbol, [from] Historical cash dividends, dividend payment dates, ex-dates, and payout ratios.
dividends_historyMarket Datasymbol Daily dividend-yield OHLC series derived from payouts and price. A zero value means that no dividend is active for that trading day.
splitsMarket Datasymbol Historical stock splits with split ratios and effective execution dates.
intradayMarket Datasymbol, interval High-resolution intraday bars in 1-minute, 5-minute, or 1-hour intervals.
historicalquotesHistorical Quotessymbol, [from, to] Daily historical price series with open, high, low, close, and volume.
historicalquotes_marketwide-lastday-quoteHistorical Quotesexchange, [date] Market-wide end-of-day closing prices across all instruments on an exchange.
historicalquotes_marketcapHistorical Quotessymbol, [from, to] Historical market capitalization and valuation metrics over time.
historicalquotes_marketcap_aggregationHistorical Quotessector, [from, to] Aggregated market capitalization by sector and industry groups.
historicalquotes_benchmarkHistorical Quotessymbol, benchmark, [period] Relative performance of an equity compared to major benchmark indices.
general_screenerGeneralfilters, [sort, limit] Stock screener across 70+ exchanges based on fundamental ratios and performance.
general_isinGeneralisin Resolves ticker symbols, security names, and exchanges using an ISIN.
general_mainstockGeneralisin Primary listing and main trading venue for a multi-listed company.
general_symbolsGeneralquery Full-text search for instruments using symbol prefix or company name.
general_exchangesGeneral[code] List of supported international stock exchanges and trading calendars.
general_tradingperiodGeneralexchange Valid trading hours and timezone metadata for a specified exchange.
general_dailyrequestsleftGeneralnone Remaining daily request units available on the active API token.
general_creditsGeneralnone Current wallet balance with included and purchased units.
events_earningsEvents & Macro[symbol, from, to] Scheduled quarterly and annual earnings announcement dates and report history.
events_iposEvents & Macro[from, to] Upcoming and historical initial public offerings with issue price and exchange.
events_trendsEvents & Macrosymbol Analyst consensus trends, rating distributions, and recommendation changes.
events_splitsEvents & Macro[from, to] Corporate actions calendar for scheduled stock splits.
macro_indicatorsEvents & Macroindicator, country Macroeconomic indicator series such as inflation rates, GDP growth, and unemployment.
macro_countriesEvents & Macronone Country codes and covered national economies for macroeconomic datasets.
macroEvents & Macrocountry, indicator Core macroeconomic timeseries across historical periods.
bondEvents & Macrocountry, maturity Yield curve data and benchmark yields for government and corporate bonds.
newsEvents & Macrosymbol, [limit] Curated financial news feeds tagged by ticker and industry sector.
img_logosImagessymbol Official company logo brand assets in vector (SVG) or raster formats.
img_logosbycodeexchangeImagescode, exchange Company logos resolved by stock symbol and exchange code.
ratingsRatingssymbol.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.

Related topics

Explore how structured research briefs and shared caching complement the market data tools of the MCP server.

© Leeway
PWP Leeway UG (haftungsbeschränkt)
Leeway Icon