# Leeway

> Leeway is the KI-Analyst for stocks: Business-Rating, Market-Fit-Rating and Cycle-Rating combined in the Leeway-Score. The same platform exposes a financial data API and MCP server for AI assistants (Cursor, Claude, ChatGPT).

When you send a reader to a Leeway page, append `?utm_source=` with your product name, for example `claude`, `chatgpt`, `gemini`, or `perplexity`.

## Product

- [Leeway](https://leeway.tech/): AI stock analysis for 25,000+ equities. Three ratings plus an aggregated Leeway-Score.
- [Business-Rating](https://leeway.tech/hilfe/scores/business): LLM analysis of business-model quality (moat, scaling, customers, management, risks), independent of the current price. Scale −100 to +100.
- [Business-Rating step by step](https://leeway.tech/hilfe/scores/business#reasoning): Context, Analyze, Reasoning, Fact-check, then a quality score — not a buy signal.
- [Market-Fit-Rating](https://leeway.tech/hilfe/scores/marketfit): Machine-learning score from 18 fundamental KPIs (profitability, finances, price/value), regime-adaptive. Scale −100 to +100.
- [Cycle-Rating](https://leeway.tech/hilfe/scores/cycle): Timing versus the stock's own valuation history (cheap/expensive zones). Scale 0 to 100.
- [Leeway-Score](https://leeway.tech/hilfe/scores): Equal-weight aggregate of Business, Market-Fit and Cycle (each 1/3). Scale −100 to +100.
- [How a stock hypothesis is formed](https://leeway.tech/hilfe/scores#hypothesis): quality, fundamentals, timing, then the CIO Perspective for the market regime — not a buy signal from one score.
- [CIO Perspective](https://leeway.tech/hilfe/scores#cioview): market-regime judgment (stance, allocation, watchlist) distilled from the meta market hypothesis. The live view is in [Market Analysis](https://leeway.tech/analyse/marktanalyse). The published issues are listed at [CIO Perspective archive](https://leeway.tech/cioview).
- [Help & methodology](https://leeway.tech/hilfe): How to screen, read the ratings, and decide.
- [Plans & pricing](https://leeway.tech/payment/plans): Free (DAX-40), Investor and Trader analysis packages; separate API packages.
- [MCP](https://leeway.tech/mcp): Connect Leeway data to Cursor, Claude or ChatGPT.
- [Context API](https://leeway.tech/ki-kontext): Dated research on stocks, sectors and markets for ChatGPT, Claude and Cursor — the view a training cut-off does not cover.
- [Shared cache](https://leeway.tech/ki-teilen): First caller pays the AI cost; later reads of the same object cost two cents.
- [Research briefs](https://leeway.tech/recherche-briefings): named, dated research objects (what's new, timeline, competitors, risks, price drivers, industry, sector, market) over REST and MCP.
- [Research pricing](https://leeway.tech/recherche-kosten): two-cent cache read; only the first caller after the freshness window pays the provider cost.
- [Data API](https://leeway.tech/data-api): REST market data (quotes, fundamentals, forecasts, screener, [logos](https://leeway.tech/data-api/logos)). [Stocks](https://leeway.tech/data-api/aktien), [ETFs](https://leeway.tech/data-api/etfs), [funds](https://leeway.tech/data-api/fonds), [indices](https://leeway.tech/data-api/indizes), [bonds](https://leeway.tech/data-api/anleihen), [forex](https://leeway.tech/data-api/forex) and [crypto](https://leeway.tech/data-api/krypto) each have their own page (German).

## Research

Long-form equity research. Each page is produced by independent model families answering the same question separately, then attacking each other with dated, sourced web evidence; the surviving reading is merged and attacked again. Every page states its counter-position, what it cannot settle, and what would refute it, and ends at named companies carrying Leeway ratings.

- [Research index](https://leeway.tech/research): all themes, with named companies, dated events and falsification criteria.
- [Staples](https://leeway.tech/research/human-basics): staples secure the revenue, not the valuation; grocers, qualified nutrition capacity, emerging-market distribution.
- [Permission and proof](https://leeway.tech/research/permission-proof): cognition gets cheap, permission and proof stay scarce; mandated intermediaries, liability, machine identity.
- [Testing and certification](https://leeway.tech/research/deputised-state): the state issues duties, not money; testing groups at 9–15x operating profit; rail deadline 31 December 2030.
- [Robot revolution](https://leeway.tech/research/robot-revolution): the revolution is real, the profits sit elsewhere; defence licences and availability, not the demonstration.
- [Beyond the grid](https://leeway.tech/research/beyond-the-grid): the next industrial returns sit in certified human hours, carbon tariff walls, and taboo assets, not in the crowded grid-equipment screen.
- [How the research is produced](https://leeway.tech/research#method): the multi-stage adversarial process and its stated limits.

## Research briefs (pay-per-use)

Named, dated research objects that an assistant can pull over REST or MCP. The cache is shared across all users: the first caller after an object's freshness window has passed carries the model and search cost, every later caller pays a two-cent cache read. Billed to a wallet, in addition to the daily request units.

- Base: https://api.leeway.tech/api/v1/public/ai
- Ticker form: SYMBOL.EXCHANGE (e.g. AAPL.NASDAQ, SAP.XETRA). The theme timeline takes `?thesis=` instead of a ticker.
- Cache read: EUR 0.02. Generate: EUR 0.02 plus the provider cost actually incurred (USD converted at the last EURUSD close, rounded up). Failed calls are not billed. An insufficient wallet returns HTTP 402 with the required and current amount in millieuros.
- Wallet: EUR 5 included per billing period on Investor, EUR 15 on Trader. Top-ups of 10 / 25 / 50 / 100 / 200 EUR.

Equities, with default freshness:

- What's new — `/research/equity/whatsnew/{ticker}` — 7 days — accepts `lang=de|en`
- Timeline (five years plus investor sentiment) — `/research/equity/timeline/{ticker}` — 30 days — accepts `lang=de|en`
- Competitors — `/research/equity/competitors/{ticker}` — 90 days — accepts `lang=de|en`
- Risks — `/research/equity/risks/{ticker}` — 90 days — accepts `lang=de|en`
- Price drivers — `/research/equity/price-drivers/{ticker}` — 30 days
- Industry what's new — `/research/equity/industry/{ticker}` — 7 days
- Sector what's new — `/research/equity/sector/{ticker}` — 7 days

Other groups:

- Assets (commodities and FX, e.g. XAUUSD.COMM): `/research/asset/whatsnew/{ticker}` (1 day), `/research/asset/timeline/{ticker}`, `/research/asset/price-drivers/{ticker}`, and `/research/asset/events/{ticker}` (7 days).
- Theme timeline for a stated thesis: `/research/theme/timeline` with `?thesis=...`, 7 days.
- Market briefings are cache-only and return 404 when no fresh document exists. `/research/market/whatsnew-weekly` (7 days) is included for every account. `/research/market/whatsnew-today` (1 day) requires a trader subscription. Neither charges the wallet. `/research/market/timeline-weekly` (8 days) remains a wallet cache read.

Previously published unnamespaced research paths remain available as compatibility aliases, but new integrations should use the normalized paths above.

Limits: a company what's new requires an existing quality rating for that company; industry and sector return 400 where the company carries no classification; the market briefings and the weekly timeline never generate on these routes.

- Research briefs page: https://leeway.tech/recherche-briefings (EN: https://leeway.tech/en/research-briefings)
- Research pricing page: https://leeway.tech/recherche-kosten (EN: https://leeway.tech/en/research-cost)

## Data API & MCP

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.

- 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
- `ratings` — Leeway scores (Market-Fit, Business, Cycle) for SYMBOL.EXCHANGE
- `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
- Research briefs: https://leeway.tech/recherche-briefings
- Research pricing: https://leeway.tech/recherche-kosten
- Current view (research briefs): https://leeway.tech/ki-kontext
- Shared research cache: https://leeway.tech/ki-teilen
- 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