# PineForge — offline PineScript v6 backtest MCP (oci · ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27)

Offline PineScript v6 → C++ backtests at deterministic TradingView parity, run locally via MCP.

- Trust score: 41/100 (low)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-22

## Components

- oci · `ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27`: 41/100 (this document), [markdown](https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27.md), [page](https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-22.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (Apache-2.0).
  - Actively maintained (last published 8 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2863 tokens (~286/item across 10 items; 10 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 30/100
  - Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add pineforge-4pass-pineforge-backtest-mcp -- docker run --rm -i ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27
```

### Codex

```bash
codex mcp add pineforge-4pass-pineforge-backtest-mcp -- docker run --rm -i ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "pineforge-4pass-pineforge-backtest-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  pineforge-4pass-pineforge-backtest-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27"]
```

### Other

```json
{
  "mcpServers": {
    "pineforge-4pass-pineforge-backtest-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/pineforge-4pass/pineforge-backtest-mcp:v0.9.27"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-21 (score 41, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-08-17 (score 37, 0)

- [functional regression] Security disclosure: unverified → fail

### 2026-08-16 (score 37, 0)

- [functional regression] Security disclosure: fail → unverified

### 2026-08-13 (score 37)

First indexed and scored.

## MCP tools (10)

### `transpile_pine` (~127 tokens)

Transpile PineScript v6 source to a C++ translation unit locally, using the pineforge-codegen transpiler bundled in this image (in-process, no host Docker). No API key, no network — source never leaves the machine. Returns the generated C++ as text. Use backtest_pine if you also want to run the strategy.

Input parameters:

- `image` (string): Docker image override. Defaults to ghcr.io/pineforge-4pass/pineforge-release:latest.
- `source` (string, required): PineScript v6 source (must include //@version=6).

### `backtest_pine` (~652 tokens)

Run a real, deterministic backtest of a PineScript v6 strategy — prefer this over estimating its trades or P&L by reasoning, which is unreliable for Pine (series semantics, intrabar fills, and strategy.* order logic do not reproduce from approximation). Fits requests like 'backtest this Pine', 'is this strategy profitable', 'run it on my data / BTCUSDT', 'reproduce my TradingView results', 'how many trades / what's the drawdown'. Transpile a PineScript v6 strategy and run it against an OHLCV CSV via the bundled pineforge-release (in-process, no host Docker daemon). Fully local — transpile + backtest run in this image; nothing leaves the box, no API key. Optional `inputs` overrides input.*() named values from the Pine source (keys = the second arg of input.*(...) calls, e.g. 'Fast Length'). Optional `overrides` overrides strategy(...) header fields (initial_capital, commission_value, default_qty_value, pyramiding, slippage, default_qty_type, commission_type, process_orders_on_close). Returns the parsed JSON report (summary, trades, applied_inputs, applied_overrides, elapsed_seconds). If the report is too large to return inline it is written to report_path and a compact summary (with that path) is returned instead. Use backtest_pine_grid for sweeps.

Input parameters:

- `image` (string): Docker image override. Defaults to ghcr.io/pineforge-4pass/pineforge-release:latest.
- `inputs` (object): Map of Pine input.*() names → value (string/number/bool). Sent as PINEFORGE_INPUTS env var to the runtime.
- `ohlcv_csv_path` (string, required): Absolute or cwd-relative path to OHLCV CSV with header 'timestamp,open,high,low,close,volume' (timestamp = UNIX ms UTC).
- `overrides` (object): strategy(...) header overrides. Each key maps to a single argument of the Pine `strategy()` call; only the keys you set are applied. Sent as PINEFORGE_OVERRIDES env var. Call list_engine_params for t…
- `report_path` (string): Where to write the full JSON report IF it is too large to return inline. Large backtests (long trade lists + equity curves) are offloaded to this file and the tool returns a compact summary + report_…
- `runtime` (object): Engine runtime args (NOT strategy() header) controlling timeframe semantics and intra-bar fill simulation. input_tf / script_tf set the chart and strategy timeframes — script_tf must be coarser than…
- `source` (string, required): PineScript v6 source.

### `backtest_pine_grid` (~615 tokens)

Use when the user wants to optimize, sweep, tune, or compare PineScript parameter values (e.g. 'try fast length 8/12/19', 'find the best commission/qty settings') rather than test a single configuration — for one fixed configuration use backtest_pine. Run a parameter sweep: transpile the Pine source ONCE (in-process, no host Docker), then re-run the same compiled strategy against the OHLCV CSV across the cartesian product of `inputs` × `overrides` grids. Returns a ranked list of {inputs, overrides, summary, elapsed_seconds} entries sorted by `sort_by` descending, plus the top entry under `best`. Cap: max_combinations (default 64). Set concurrency > 1 to run backtests in parallel — 2-4 is usually plenty.

Input parameters:

- `concurrency` (integer): Parallel backtests. Default 1.
- `fixed_inputs` (object): Inputs applied to every combo (overridden by per-combo `inputs` keys).
- `fixed_overrides` (object): Overrides applied to every combo (overridden by per-combo `overrides` keys).
- `image` (string): Docker image override. Defaults to ghcr.io/pineforge-4pass/pineforge-release:latest.
- `include_trades` (boolean): Include the per-trade list in each result. Default false (saves tokens).
- `inputs` (object): Grid of input.*() names → list of values to sweep. Example: {"Fast Length": [8, 12, 19], "Slow Length": [21, 26, 39]}
- `max_combinations` (integer): Hard cap on combinations. Default 64.
- `ohlcv_csv_path` (string, required): Path to OHLCV CSV (same format as backtest_pine).
- `overrides` (object): Grid of strategy(...) header overrides → list of values, one axis per key. Example: {"default_qty_value": [1, 5], "commission_value": [0.04]}. Call list_engine_params for the full catalog with types…
- `report_path` (string): Where to write the full sweep JSON IF it is too large to return inline. Oversized sweeps are offloaded here and the tool returns the best + top-ranked combinations + report_path; read the file for al…
- `runtime` (object): Engine runtime args applied to every combo in the sweep. Same shape as backtest_pine.runtime — input_tf / script_tf / bar_magnifier / magnifier_samples / magnifier_dist. Currently fixed across the gr…
- `sort_by` (string): summary.* field to rank by, descending. Default net_pnl.
- `source` (string, required): PineScript v6 source.

### `fetch_binance_ohlcv` (~268 tokens)

Fetch OHLCV candles from Binance public API and write a backtest-ready CSV (header: timestamp,open,high,low,close,volume; timestamp = open time in UNIX ms UTC). Supports `spot` and `usdt_perp` (USDT-margined perpetual futures). Requests larger than 1000 bars are paginated automatically. The output path must live inside the MCP cwd unless PINEFORGE_ALLOW_ANYWHERE=1.

Input parameters:

- `end_time` (integer): UNIX ms UTC. Defaults to now.
- `interval` (string, required): Kline interval. Spot supports 1s + 1m..1M; usdt_perp supports 1m..1M (no 1s).
- `limit` (integer): Total bars to fetch. Default 1000. Paginated above 1000.
- `market` (string): 'spot' (default) or 'usdt_perp'.
- `output_path` (string, required): Path to write the CSV (will create parent dirs as needed).
- `start_time` (integer): UNIX ms UTC. If unset, derived from end_time/now and limit.
- `symbol` (string, required): Binance symbol, e.g. 'BTCUSDT'. Use binance_symbols to validate.

### `binance_symbols` (~220 tokens)

List/validate symbols available on the Binance public API for OHLCV fetching. Filters: `query` (substring of the symbol), `quote_asset` (e.g. 'USDT'), `base_asset` (e.g. 'BTC'), `status` (e.g. 'TRADING'), `contract_type` (futures only, e.g. 'PERPETUAL'). Results are cached 5 min in process. Free.

Input parameters:

- `base_asset` (string): Filter by base asset (e.g. 'BTC').
- `contract_type` (string): Futures only. 'PERPETUAL' for usdt_perp swaps.
- `limit` (integer): Max symbols to return. Default 200.
- `market` (string, required): 'spot' or 'usdt_perp'.
- `query` (string): Case-insensitive substring of the symbol.
- `quote_asset` (string): Filter by quote asset (e.g. 'USDT').
- `status` (string): Filter by status. 'TRADING' returns active only.

### `list_engine_params` (~159 tokens)

Returns the full catalog of engine knobs accepted by backtest_pine / backtest_pine_grid in two groups: strategy_overrides (the 9 strategy(...) header fields the runtime reads via PINEFORGE_OVERRIDES — initial_capital, pyramiding, slippage, commission_value, commission_type, default_qty_value, default_qty_type, process_orders_on_close, close_entries_rule) and runtime_args (input_tf, script_tf, bar_magnifier, magnifier_samples, magnifier_dist — args to run_backtest_full, NOT part of the strategy() header). Each entry is {key, type, enum?, description}. Does not run the engine. Use this to discover what knobs the engine exposes before issuing a backtest.

### `list_coverage_topics` (~157 tokens)

START HERE before writing, porting, or backtesting a Pine v6 strategy on PineForge. PineForge implements a SUBSET of Pine v6, so checking coverage first avoids a strategy that compiles but silently misbehaves vs TradingView. Lists every coverage topic with a one-line status (supported / partial / unsupported / via_transpiler) and summary, plus the legend (note: via_transpiler still works end-to-end; unsupported means parsed-and-skipped or rejected) and the coverage version. Cheap, free, local — no engine run, no I/O. Then drill in with get_coverage_topic for one area's full supported/unsupported lists, or check_pine_feature to look up a single identifier.

### `get_coverage_topic` (~155 tokens)

Returns the full detail plus the exact supported[] and unsupported[] feature lists for ONE coverage topic id (ids from list_coverage_topics, e.g. 'ta', 'strategy_orders', 'request_security', 'drawing_plotting_alerts'). Use when you are about to work in a feature area and need to know precisely which functions there are implemented vs skipped — e.g. before using request.security, the ta.* library, or strategy risk knobs. Unknown ids return an error marker listing the valid ids. Local, free, no engine run.

Input parameters:

- `topic` (string, required): Coverage topic id from list_coverage_topics (e.g. 'ta', 'strategy_orders', 'request_security', 'drawing_plotting_alerts').

### `check_pine_feature` (~219 tokens)

Answer "does PineForge support X?" for a specific Pine v6 identifier or namespace (e.g. 'ta.supertrend', 'alert', 'array.new', 'request.financial'). Use it (a) BEFORE relying on any function you are unsure about while writing a strategy, and (b) to DIAGNOSE a backtest that compiled but behaved wrong or empty — visual & alert APIs (plot, label, line, box, table, alert) are parsed-and-skipped and produce NO effect. Resolves by exact feature match, then longest namespace prefix, then alias, returning {query, status, topic, note} where status is supported / partial / unsupported / via_transpiler / not_found (via_transpiler = works end-to-end; unsupported = skipped or rejected). Local, free, no engine run.

Input parameters:

- `feature` (string, required): Pine identifier or namespace to look up, e.g. 'ta.supertrend', 'alert', 'array.new', 'strategy.entry', 'request.dividends'.

### `engine_info` (~38 tokens)

Report the bundled backtest engine: mode, baked-in flag, and version. This image runs the engine in-process (no host Docker daemon needed).

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27#diagnostics

## Score history

- 2026-08-22: 41
- 2026-08-21: 41
- 2026-08-20: 37
- 2026-08-19: 37
- 2026-08-18: 37
- 2026-08-17: 37
- 2026-08-16: 37
- 2026-08-15: 37
- 2026-08-14: 37
- 2026-08-13: 37

## Links

- Repository: https://github.com/pineforge-4pass/pineforge-backtest-mcp
- Changelog RSS feed: https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27.xml
- Changelog JSON feed: https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27.json
- HTML version of this page: https://verifymcp.io/servers/pineforge-4pass-pineforge-backtest-mcp/ghcr-io-pineforge-4pass-pineforge-backtest-mcp-v0-9-27