Pariflow Agent MCP

Use Pariflow from your AI agent

Ask your agent to surface mapped market signals, reject conflicts, and turn a rule set into a persistent 30-day DEMO strategy. Review the draft once, explicitly activate it, then inspect every scheduled run from the conversation.

Connect your agent Try the workflow

Real Codex sessionDeterministic DEMO dataPersistent strategy active

Read the demo transcript

User: Show me the five biggest whale buys above $70k that settle this week. Flag anything that conflicts with an earlier whale trade. Just give me the shortlist—don't place anything yet.

Codex: Three signals pass the filters. A fourth is flagged because of earlier opposite flow, and the signal outside the seven-day window is omitted.

User: These three look good. Set up a 30-day demo strategy using the risk limits from our research, check for new signals every six hours, and start it now. Show me what happened on the first run.

Codex: Pariflow MCP creates and activates the DEMO-only strategy. The first run evaluates five signals, accepts three, skips two with reasons, places three bounded DEMO orders totaling $1,000, and returns the end date and next scheduled scan. No LIVE funds are used.

What the MCP is for

Pariflow MCP gives an agent a small, auditable toolset for moving from a market question to a reviewable decision. Start with a read-only key; add trading permission only when the workflow needs it.

Scan signal flow

Pull the largest mapped trades for a time window, then filter by side, size, and recency.

Resolve the exact market

Match a signal to one event and one outcome before treating it as actionable.

Save the rule set

Create a DEMO strategy draft with fixed sizing, exposure, cadence, and duration limits.

Run it on schedule

Activate once with explicit confirmation, then review each scan, decision, DEMO order, and next run.

Connect your agent

The CLI stores the key locally and exposes Pariflow as a stdio MCP server. A read-only key covers research and previews; creating or activating an automated DEMO strategy requires a key with trading permission.

1. Create a scoped key

Open Settings → Agent access, name the key, and leave trading disabled unless the agent must place DEMO or LIVE orders. The full key is shown once, while the guided client setup uses a separate one-time code that expires after 10 minutes.

2. Choose Codex, Claude, or Cursor

After creating the key, choose a client:

Codex opens a new task with the complete setup prompt prefilled.
Claude opens Claude Code with the same bounded setup prompt.
Cursor uses Cursor’s native one-click MCP installer and copies the follow-up prompt to your clipboard.

The setup code is single-use, so create a separate scoped key when you want to connect another client.

The agent installs the local stdio runtime when needed, exchanges the short-lived setup code, and stores the permanent credential in ~/.pariflow/agent.json with owner-only permissions. The permanent API key is never placed in a deep link, prompt, or chat transcript.

The bootstrap currently supports macOS and Linux and requires Node.js 20 or newer.

3. Verify the connection

The setup prompt asks the client to call the MCP’s get_started tool after connecting. The reply should contain the main use cases, the safe search → resolve → preview → confirm sequence, and three useful starter prompts.

Manual CLI fallback

Install and configure the CLI manually when app links are unavailable:


curl -fsSL https://pariflow.com/api/agent/install | sh
"$HOME/.local/bin/pariflow-agent" configure --base-url https://pariflow.com --api-key YOUR_AGENT_KEY

You can use environment variables instead of the local CLI config:


export PARIFLOW_BASE_URL=https://pariflow.com
export PARIFLOW_API_KEY=YOUR_AGENT_KEY

Then add the MCP server to your agent:

Use the installed executable as the local stdio command:


{
  "mcpServers": {
    "pariflow": {
      "command": "sh",
      "args": ["-lc", "\"$HOME/.local/bin/pariflow-agent\" mcp"]
    }
  }
}

Keep the API key local. Never paste it into a prompt, issue, log, screenshot, or browser-visible script.

Try the workflow

Start with a bounded read-only request. This prompt separates retrieval from judgment:


Show me the five biggest whale buys above $70k that settle this week.
Flag anything that conflicts with an earlier whale trade.
Just give me the shortlist — don't place anything yet.

Then ask the agent to save a strategy draft. Creating the draft does not start it:


These three look good. Set up a 30-day demo strategy for them using
the risk limits from our research:

- risk 3% to 10% of equity per position
- cap one position at $500
- cap new daily risk at $1,000
- keep open exposure below 40%
- assume 1 cent of slippage
- check for new signals every 6 hours

Save it as a draft first so I can review it.

After reviewing the draft, activate it explicitly:


Looks good. Start the demo strategy now and run the first scan.
Tell me what it placed, when it ends, and when it scans again.

Research workflowSee how the rule set behaves over a 30-day paper replay.

Read the methodology →

Read signalsApply rulesCreate draftExplicitly startReview scheduled runs

MCP tools

Tool	Permission	Use it for
`get_account_summary`	`read`	Read balances, account mode, and account limits before sizing risk.
`get_top_trades`	`read`	Return the largest mapped trades for a defined date window.
`search_markets`	`read`	Search markets by team, event, or topic.
`prepare_trade_target`	`trade`	Resolve an external signal to an exact Pariflow event and outcome.
`preview_trade`	`read`	Return an estimated or quoted price, including LIVE quote expiry.
`place_trade`	`trade`	Place a DEMO or LIVE order after explicit confirmation.
`list_orders`	`read`	Review the account’s recent orders and their current status.
`create_strategy`	`trade`	Save a bounded, persistent DEMO-only strategy draft.
`start_strategy`	`trade`	Activate a draft with `confirm: true`; optionally run its first scan immediately.
`pause_strategy`	`trade`	Stop future scans without deleting run history.
`get_strategy_status`	`read`	Inspect lifecycle status, latest run, end date, and next scan.
`list_strategies`	`read`	List the account’s saved strategies and latest run totals.

For LIVE market orders, preview responses include a short-lived quoteId and quoteExpiresAt. If the quote expires or liquidity changes, request a new preview before placing the order.

Safety boundaries

Read keys cannot trade

Use them for discovery, analysis, account context, and previews.

Drafts never auto-start

Creating a strategy only saves its rules. Activation requires confirm: true.

Automation is DEMO-only

Scheduled strategies cannot use LIVE funds. Direct LIVE orders keep their separate confirmation flow.

Account limits still apply

Balance, order-size, daily-volume, exposure, quote-expiry, and rate limits remain enforced.

Active strategies run server-side, so they continue after Codex closes. Every scan is persisted with accepted, skipped, failed, and placed-order counts. Revoking the strategy’s key, disabling its account, or invalidating its terms authorization pauses future scans.

When an agent presents a trade or preview, it should show the market, outcome, side, amount, price, account mode, and order status. It should not expose private infrastructure, routing, wallet operations, or internal runbooks.

CLI reference

The same account tools are available directly from the terminal:


pariflow-agent top-trades --limit 5
pariflow-agent search-market "rate cut"
pariflow-agent preview-trade --event-id EVENT_ID --option YES --side buy --amount 25 --account-mode DEMO
pariflow-agent trade --event-id EVENT_ID --option YES --side buy --amount 25 --account-mode DEMO --confirm
pariflow-agent create-strategy --duration-days 30 --scan-interval-minutes 360
pariflow-agent start-strategy --strategy-id STRATEGY_ID --confirm
pariflow-agent strategy-status --strategy-id STRATEGY_ID
pariflow-agent pause-strategy --strategy-id STRATEGY_ID

Troubleshooting

Error	What to do
`Authentication required`	Check `PARIFLOW_API_KEY` or the local CLI config.
`Access denied`	Use a key with the required permission. Order placement requires `trade`.
`Quote unavailable`	Preview again, reduce the amount, or choose another market.
`CONFIRM_REQUIRED`	Add `confirm: true` or use `--confirm` for a CLI trade.
`EVENT_NOT_FOUND`	Run `search_markets` or `prepare_trade_target`, then use the returned identifiers.
`DEMO_ONLY_AUTOMATION`	Automated strategies cannot be activated with LIVE funds.
`STRATEGY_AUTHORIZATION_INVALID`	Renew the key or account authorization, then explicitly resume the strategy.
`Rate limit exceeded`	Wait before retrying or reduce polling frequency.

Related: Authentication and Market Data