# pinescript-audit-mcp

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Live on MCPize](https://img.shields.io/badge/Live%20on-MCPize-6d28d9)](https://mcpize.com/mcp/pinescript-audit-mcp)

An MCP server that statically audits Pine Script v6 strategies for the specific traps that compile clean, backtest beautifully, and then diverge from live behavior.

## The problem this solves

Pine Script strategies can compile with zero errors and still behave differently live than in the backtester — fill-timing assumptions, ATR-smoothing mismatches, lookahead bias, VWAP-anchoring drift, and exit-drift are all silent, syntactically valid patterns that the compiler has no reason to flag. This catches them before they cost real money finding out live.

## What it catches

- **Fill-timing traps** — orders that backtest as filling at a price/bar the live broker can't actually match
- **ATR-smoothing mismatches** — RMA vs. SMA vs. EMA smoothing assumptions that quietly change signal timing
- **Lookahead bias** — `request.security()` and similar calls that leak future bar data into historical evaluation
- **VWAP-anchoring drift** — anchor-period assumptions that behave differently on session boundaries live vs. in backtest
- **Exit-drift** — exit logic that behaves differently depending on `calc_on_every_tick` and bar-close assumptions
- **Pine v6 syntax traps** — v6-specific footguns that compile but change behavior from v5 equivalents

## Tools

### `audit_pine_strategy`
Runs the full static-analysis pass against a submitted Pine Script v6 strategy and returns every trap found, with the specific line and a plain-English explanation of the backtest-vs-live divergence it causes.

## Use it

**Hosted (recommended):** [MCPize](https://mcpize.com/mcp/pinescript-audit-mcp) — free tier, paid Pro tier for higher limits.

**Self-host:**
```bash
npm install
node server.js
```

## Part of the AlgoForge suite

Prop-firm and quant-validation tools for algo traders: [prop-rules-mcp](https://github.com/tylerscomic-lab/prop-rules-mcp), [trade-journal-mcp](https://github.com/tylerscomic-lab/trade-journal-mcp), [payout-calc-mcp](https://github.com/tylerscomic-lab/payout-calc-mcp), [econ-calendar-mcp](https://github.com/tylerscomic-lab/econ-calendar-mcp), [montecarlo-validator-mcp](https://github.com/tylerscomic-lab/montecarlo-validator-mcp), [overfitting-audit-mcp](https://github.com/tylerscomic-lab/overfitting-audit-mcp), [walkforward-validator-mcp](https://github.com/tylerscomic-lab/walkforward-validator-mcp), [backtest-cost-sensitivity-mcp](https://github.com/tylerscomic-lab/backtest-cost-sensitivity-mcp), [pinescript-mcp](https://github.com/tylerscomic-lab/pinescript-mcp).

## License

MIT