Pariflow Agent MCP connects MCP-compatible clients to Pariflow market discovery, account context, trade previews, explicitly confirmed orders, and persistent DEMO-only strategies.

Requirements

Node.js 20 or newer
A Pariflow account
A scoped Pariflow agent key or single-use setup code

Start with a read-only key. Enable the trade permission only when the client must place DEMO or LIVE orders.

Install and connect

Create a scoped key in Pariflow → Settings → Agent access, then enter the single-use setup code in your MCP client's secret configuration field. The Registry package runs:

npx -y @pariflow-market/mcp mcp

with this secret environment variable:

PARIFLOW_SETUP_CODE=<single-use setup code>

On first launch, the code is exchanged locally for the scoped agent key. The permanent key is written to ~/.pariflow/agent.json with owner-only permissions. The setup code expires after 10 minutes and cannot be reused by a different installation.

For manual setup, expose the code through a local secret manager and run:

npx -y @pariflow-market/mcp connect

The connect command reads PARIFLOW_SETUP_CODE. Do not place the code or a permanent API key in source control, screenshots, prompts, or issue reports.

You may alternatively provide PARIFLOW_API_KEY directly. PARIFLOW_BASE_URL is optional and defaults to https://pariflow.com.

Manual MCP configuration

After connect has stored the scoped key, clients that use JSON configuration can start the server without embedding a credential:

{
  "mcpServers": {
    "pariflow": {
      "command": "npx",
      "args": ["-y", "@pariflow-market/mcp", "mcp"]
    }
  }
}

Safety model

Read-only keys cannot place orders.
preview_trade never executes an order.
place_trade requires exact market identifiers, confirm: true, and a fresh idempotency key.
Strategy creation only saves a draft.
Starting a strategy requires confirm: true.
Persistent strategies are DEMO-only.
Account, exposure, quote-expiry, and rate limits remain enforced by Pariflow.

Prediction markets and LIVE trading may be restricted in your jurisdiction. Users are responsible for eligibility and compliance with applicable law and the Pariflow Terms of Service.