<div align="center">

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/decodetick/decodetick-mcp/main/docs/assets/logo-dark.svg">
  <img alt="Decodetick MCP" src="https://raw.githubusercontent.com/decodetick/decodetick-mcp/main/docs/assets/logo.svg" width="440">
</picture>

# Decode the tick. Find the edge.

Market intelligence for your AI assistant - algo-trading strategies, analytics and specialized research knowledge.

[![PyPI](https://img.shields.io/pypi/v/decodetick-mcp)](https://pypi.org/project/decodetick-mcp/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](https://github.com/decodetick/decodetick-mcp/blob/main/LICENSE)
[![Python 3.14+](https://img.shields.io/badge/python-3.14%2B-blue)](https://python.org)

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=decodetick&config=eyJ1cmwiOiJodHRwczovL21jcC5kZWNvZGV0aWNrLmNvbS9tY3AifQ%3D%3D)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_decodetick-0098FF?logo=githubcopilot)](https://insiders.vscode.dev/redirect/mcp/install?name=decodetick&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.decodetick.com%2Fmcp%22%7D)

</div>

> ### Just ask
>
> - *"What strategy works best on AAPL?"*
> - *"Show me the top strategy's backtest - return, max drawdown, win rate."*
> - *"How risky is BTC?"*
> - *"How do I avoid overfitting a backtest?"*

## Getting started

**Standard config** works in most MCP clients:

```json
{
  "mcpServers": {
    "decodetick": {
      "url": "https://mcp.decodetick.com/mcp"
    }
  }
}
```

It works without an account; sign in with Decodetick for higher usage limits.

<details>
<summary><b>Cursor</b></summary>

Click the **Add to Cursor** button above, or add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "decodetick": {
      "url": "https://mcp.decodetick.com/mcp"
    }
  }
}
```
</details>

<details>
<summary><b>VS Code</b></summary>

Click the **Install in VS Code** button above, or use the CLI:

```bash
code --add-mcp '{"name":"decodetick","type":"http","url":"https://mcp.decodetick.com/mcp"}'
```

or add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "decodetick": {
      "type": "http",
      "url": "https://mcp.decodetick.com/mcp"
    }
  }
}
```
</details>

<details>
<summary><b>Claude Code</b></summary>

```bash
claude mcp add --transport http decodetick https://mcp.decodetick.com/mcp
```

Add `--scope user` to enable it in every project.
</details>

<details>
<summary><b>Claude Desktop / claude.ai</b></summary>

**Settings → Connectors → Add custom connector**, then enter:

```
https://mcp.decodetick.com/mcp
```

Connectors are account-level, so the server is available in both the desktop
app and claude.ai. Sign in with Decodetick when prompted, or skip it to continue
without an account.
</details>

<details>
<summary><b>ChatGPT</b></summary>

Custom MCP connectors need **Developer mode** (Plus/Pro/Team/Enterprise/Edu):

1. **Settings → Connectors → Advanced** - enable *Developer mode*.
2. **Settings → Connectors → Create** - name it `Decodetick`, set the MCP
   server URL to `https://mcp.decodetick.com/mcp`, pick *OAuth* (or
   *No authentication* to use it without an account), and create.
3. In a chat, open **+ → Developer mode** and toggle Decodetick on.
</details>

<details>
<summary><b>Self-hosted (PyPI / Docker)</b></summary>

```bash
uvx decodetick-mcp             # run straight from PyPI
pip install decodetick-mcp     # or install
docker run -p 8080:8080 $(docker build -q .)  # or containerized
```

`uvx` and `pip` run the server over stdio; the Docker image serves streamable
HTTP on `localhost:8080`. Sign-in with Decodetick is available on the hosted
server.
</details>

## How it works

You ask in plain language. The AI picks the right tool. You get an answer with
evidence - strategy metrics you can rank, or research passages you can cite -
not a data dump.

| You ask                                        | You get                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------- |
| *"What strategy works best on AAPL?"*          | Strategies backtested on AAPL, ranked by their score on it          |
| *"How risky is BTC?"*                          | The instrument dossier - volatility, drawdowns, character fingerprint |
| *"What does the research say about position sizing?"* | Ranked passages with `slug` + `locale` for citation          |

## Tools

Four read-only tools.

- **leaderboard** - the strategy leaderboard: published, backtested
  strategies, ranked. Sort by score or by backtested APY - `apy_desc` ranks by `cagr_usd`
  (annualized return in USD, comparable across markets; a strategy without a
  USD figure sorts last); filter by family or by instrument symbol ("what works best on
  AAPL?").
- **strategy** - one strategy's full dossier: metrics, risk mode, parameters,
  and the backtest summary.
- **instrument** - the catalog of covered markets, or one instrument's
  dossier: buy-and-hold facts and the six-axis character fingerprint.
- **research** - one search across the research: articles plus, on paid
  tiers, the deeper knowledge base. Returns cited passages.

## Example prompts

**Explore the leaderboard**
```
What strategy works best on AAPL?
Show me the highest-APY strategy and its max drawdown.
Which strategy family performs best?
```

**Dig into a strategy**
```
Give me the full details on the MA Crossover strategy.
What's the win rate and risk mode of your top strategy?
```

**Explore the markets**
```
Which markets do you cover?
How risky is BTC - volatility, drawdowns, character?
```

**Search the research**
```
How do I avoid overfitting a backtest?
Find articles about position sizing and drawdown control.
```

## Disclaimer

Strategy results are hypothetical backtests on historical data. They do not
reflect actual trading, and past performance does not guarantee future results.
Nothing this server returns is investment advice or a recommendation to buy or
sell any instrument. See the
[risk disclosure](https://www.decodetick.com/en/risk-disclosure).

## Terms and privacy

Use of the hosted server is subject to the Decodetick
[Terms](https://www.decodetick.com/en/terms) and
[Privacy Policy](https://www.decodetick.com/en/privacy).

## Security

Please report vulnerabilities privately, as described in
[SECURITY.md](https://github.com/decodetick/decodetick-mcp/blob/main/SECURITY.md).

## License

MIT - [decodetick.com](https://decodetick.com)