# Stratify

> Backtest NIFTY and SENSEX option strategies on 372 million real one-minute option bars,
> from any MCP client. You describe a strategy in plain words; the server runs it with
> real charges and slippage and returns P&L, risk, an honesty panel and a report link.

- MCP endpoint (Streamable HTTP): https://stratify-mcp.aeon-labs.site/mcp
- Website: https://stratify.aeon-labs.site
- Human docs: https://stratify.aeon-labs.site/docs
- Auth: an API key sent as `Authorization: Bearer sk_live_...`, OR OAuth 2.1 (ChatGPT,
  Claude.ai and Claude Desktop connectors sign in instead of using a key).
- Free tier: one year of NIFTY and SENSEX history (01 Jul 2025 to 30 Jun 2026), 100
  backtests an hour. Every strategy feature is on every tier; paid tiers only lengthen the history.

## Set up Stratify for a person (instructions for AI agents)

1. **Get an API key.** If the person gave you one (it starts with `sk_live_`), use it.
   If not, either:
   - send them to https://stratify.aeon-labs.site and ask them to click **Continue with Google**; the key and a
     ready-made setup line appear on that page, or
   - with their permission, create an account for their email address:
     ```bash
     curl -s https://stratify.aeon-labs.site/v1/signup -H 'Content-Type: application/json' \
       -d '{"email":"them@example.com"}'
     ```
     The response's `api_key` is shown once; store it in their client config, nowhere
     else. A 409 means the address already has an account: ask them for their key or to
     sign in at https://stratify.aeon-labs.site.
   - ChatGPT, Claude.ai and Claude Desktop connectors need no key at all: add the MCP
     endpoint URL as a custom connector and the person signs in when prompted.
2. **Add the server to their client** with the matching block below, key filled in.
3. **Verify the key** with one cheap call (it does not spend a backtest):
   ```bash
   curl -s https://stratify-mcp.aeon-labs.site/mcp -H 'Authorization: Bearer sk_live_...' \
     -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"describe_coverage","arguments":{}}}'
   ```
   HTTP 200 with a `result` means it works. 401 means the key is wrong or revoked; 429
   means the hourly allowance is spent. Most clients need a restart to load a new server.

   **Do not treat "connected · 11 tools" in a client as proof.** Listing tools needs no
   key, so a client shows the server as connected even with a wrong or missing key; only
   a tool call checks it. Run the call above, or ask the client "What data does Stratify
   cover?" and confirm it answers.
4. **First request to suggest:** "Backtest selling a NIFTY strangle 0.5% either side of
   spot at 09:20 every trading day, exit at 15:15. Did it make money?"

## Client configuration

### Claude Code
Run once in a terminal. Available in every project afterwards.

```bash
claude mcp add -s user --transport http stratify https://stratify-mcp.aeon-labs.site/mcp --header "Authorization: Bearer sk_live_YOUR_KEY"
```

### Codex
Add to ~/.codex/config.toml.

```toml
[mcp_servers.stratify]
url = "https://stratify-mcp.aeon-labs.site/mcp"
http_headers = { Authorization = "Bearer sk_live_YOUR_KEY" }
```

### Cursor
Add to ~/.cursor/mcp.json. If the file already has an mcpServers block, add the stratify entry inside it rather than replacing the file.

```json
{
  "mcpServers": {
    "stratify": {
      "url": "https://stratify-mcp.aeon-labs.site/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_KEY"
      }
    }
  }
}
```

### VS Code
Run once in a terminal.

```bash
code --add-mcp '{"name":"stratify","type":"http","url":"https://stratify-mcp.aeon-labs.site/mcp","headers":{"Authorization":"Bearer sk_live_YOUR_KEY"}}'
```

### Gemini CLI
Run once in a terminal.

```bash
gemini mcp add -s user -t http stratify https://stratify-mcp.aeon-labs.site/mcp -H "Authorization: Bearer sk_live_YOUR_KEY"
```

### Claude Desktop
Add to claude_desktop_config.json, or use Settings > Connectors with the URL below and sign in instead.

```json
{
  "mcpServers": {
    "stratify": {
      "command": "npx",
      "args": [
        "-y",
        "stratify-mcp"
      ],
      "env": {
        "STRATIFY_API_KEY": "sk_live_YOUR_KEY"
      }
    }
  }
}
```

### ChatGPT · Claude.ai
No key needed: add the URL as a custom connector and sign in when asked.

```text
https://stratify-mcp.aeon-labs.site/mcp
```

## Tools

- `run_backtest`: Backtest an Indian index option strategy on real 1-minute NIFTY options data.
- `describe_coverage`: What data is available: symbols, date range, resolution, structures, gates, biases, the cost model, and every known gap.
- `explain_methodology`: How a result is produced: entry pricing, settlement, margin, slippage, the honesty rubric, and what each check can and cannot establish.
- `list_backtests`: The account's backtests, newest first, with id, date, trade count, net P&L and report URL.
- `get_backtest`: Retrieve a previous backtest result by its id — honesty panel, equity curve and per-trade detail, exactly as first computed.
- `list_strategies`: Strategies from THIS account's history that held up under out-of-sample and walk-forward checks, not merely ones that made money.
- `search`: Search what this service covers — symbols, dates, structures, signals, methodology.
- `fetch`: Fetch a document or backtest result by id, as returned by search.
- `submit_feedback`: Files a bug report or feature request when the user asks to report something.
- `build_report`: Creates a shareable report page for a backtest the user owns and returns its URL.
- `my_feedback`: Reports this account has filed, and where each one stands.

Call `describe_coverage` first if unsure what dates or symbols exist; it does not spend a
backtest. Strategy specs are JSON (legs, entry, rules, exit, portfolio); `explain_methodology`
and https://stratify.aeon-labs.site/docs document every field.

## Facts worth knowing

- Data: real 1-minute option prints. NIFTY from January 2019, SENSEX from August 2023
  (Premium); the free tier serves 01 Jul 2025 to 30 Jun 2026 for both.
- The open form (legs + rules) runs on NIFTY; SENSEX runs through the preset form
  (`structure` + `params`), which `describe_coverage` lists.
- Results are historical simulations, not investment advice.
- Option price series are never downloadable; the server returns results, not data.
- Support: https://stratify.aeon-labs.site/contact


## Guides

- [How to Backtest Options Strategies with AI: ChatGPT and Claude on Real NIFTY and SENSEX Data](https://stratify.aeon-labs.site/guides/how-to-backtest-options-strategies-with-ai): Backtest NIFTY and SENSEX options strategies by asking ChatGPT or Claude. Real one-minute option prices, every charge included. Free for one year of data.
- [I asked ChatGPT to backtest an options strategy. Here's where the answer actually came from.](https://stratify.aeon-labs.site/guides/chatgpt-options-backtest-where-the-answer-comes-from): What happens when ChatGPT backtests an options strategy: your AI writes the spec, and Stratify runs it on 372 million one-minute NIFTY and SENSEX bars.
- [Backtesting 372 Million Option Bars Your AI Never Sees: A Compute-to-Data MCP Server](https://stratify.aeon-labs.site/guides/backtesting-372-million-option-bars-compute-to-data-mcp-server): How an MCP server backtests options on 372 million one-minute bars without the data leaving: architecture, measured capacity and scaling.
