# StratVerity MCP Server

> Audit and verify algorithmic trading backtests — directly from Claude Code,
> Cursor, Windsurf, and any MCP client.

StratVerity MCP exposes backtest-audit tools to LLM coding agents. It **delegates
all computation to the StratVerity FastAPI backend** (`https://api.stratverity.com`)
and never executes submitted strategy code locally.

## Tools

| Tool | Description |
|---|---|
| `stratverity_quick_check` | Static diagnostic of a strategy excerpt (look-ahead bias, repainting, overfitting). |
| `stratverity_verify_hash` | Verify the authenticity of a sealed audit proof by SHA-256 hash. |
| `stratverity_get_badge` | Generate the embeddable badge URL for a certified audit. |

## Install

### Smithery (recommended)

```
npx -y @stratverity/stratverity-mcp
```

### Claude Code

```json
// .mcp.json
{
  "mcpServers": {
    "stratverity": {
      "command": "npx",
      "args": ["-y", "@stratverity/stratverity-mcp"]
    }
  }
}
```

### Cursor / Windsurf

Add the same server entry to your MCP config, pointing at `npx -y @stratverity/stratverity-mcp`.

## Environment

| Variable | Required | Description |
|---|---|---|
| `STRATVERITY_API_URL` | no | Backend origin (default `https://api.stratverity.com`) |
| `STRATVERITY_API_KEY` | no | Bearer token for authenticated endpoints |

## Development

```bash
npm install
npm run build          # compile to dist/
npm run dev            # run with tsx
```

## Security

- Fail-closed: any upstream error returns a structured error, never a fabricated result.
- No code execution, no live trading, no secret handling.
- Rate-limited by the upstream backend.

## License

MIT