# 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.
- Weekly briefing, daily briefing, and CIO view are stored reads. Pass `length=short` for the email and `length=long` for the website text. They do not take a freshness window and they do not generate. The weekly briefing is included for every account. The daily briefing requires a trader subscription; its email and its website article are the same text. The CIO view requires an investor or trader subscription and `lang=de` or `lang=en`. None of the three charges the wallet. A missing version returns HTTP 404. `/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 weekly briefing, the daily briefing, the CIO view, 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 an ISIN or name to SYMBOL.EXCHANGE
- `general_directory` — view=exchanges lists exchanges; view=symbols lists one exchange
- `general_screener` — filter stocks by fundamentals
- `fundamentals` — view=statements, view=keyfigures, or view=forecast for SYMBOL.EXCHANGE
- `market_cap` — view=history for one company; view=aggregation for multiples across companies
- `benchmark` — performance against benchmark indexes
- `ratings` — Leeway scores (Market-Fit, Business, Cycle) for SYMBOL.EXCHANGE
- `prices_relative_move` — whether today’s move is outside the usual range
- `general_account` — view=credits is the AI wallet; view=requests_left is the daily budget
- `ai_company`, `ai_asset`, `ai_market` — research briefs; select the brief with topic or view

## 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