aristhrottle-mcp

MCP server for Aristhrottle PRO. Lets Claude Code (or any MCP client) read and write your trading workspace state — strategies, trades, portfolios — using a workspace API key.

Install

npm install -g aristhrottle-mcp

Or run without installing:

npx aristhrottle-mcp

Get an API key

Ask the workspace owner. They'll give you a 64-character hex string. Each key is scoped to one Discord user (their own workspace, or yours if they invite you).

Configure Claude Code

Add this to your ~/.claude.json under mcpServers (or use claude mcp add):

{
  "mcpServers": {
    "aristhrottle": {
      "command": "npx",
      "args": ["-y", "aristhrottle-mcp"],
      "env": {
        "ARISTHROTTLE_API_KEY": "paste_your_64_char_key_here"
      }
    }
  }
}

For a self-hosted Aristhrottle instance, also set ARISTHROTTLE_API_BASE to your URL (defaults to https://aristhrottle.netlify.app).

Restart Claude Code. You should see the aristhrottle server in /mcp.

Tools

| Tool | What it does | | --- | --- | | health | Check the API key works; report trade/strategy counts in the default bucket. | | get_state | Fetch the raw blob for a bucket. | | put_state | Overwrite the blob for a bucket. | | list_strategies | List imported strategies (parsed from the blob). | | list_trades | Return trades, optionally filtered by strategy, side, date_from, date_to, limit. |

All tools accept an optional bucket parameter. Omit it for the default bucket (the one the website uses). Common bucket names you might create: nt8, mt5, sandbox.

Example prompts

Use health to confirm aristhrottle is connected, then use list_strategies to show what I have loaded.

Use list_trades with strategy="gen breakout" and date_from="2024-01-01". Compute Sharpe ratio and max drawdown.

Security

The API key is a bearer token. Anyone holding it can read and overwrite the workspace it's bound to. Treat it like a password. If a key leaks, the workspace owner removes it from the PELLA_API_KEYS env var on Netlify and issues you a new one.