DOCUMENTATION

Get started with OddsRail.

Set up OddsRail, understand your strategy and stay in control of what trades.

01

Start with Claude Desktop

OddsRail gives Claude tools to read Polymarket markets, review proposed orders and trade from your computer after you configure access.

  1. Install the extension.Open the .mcpb file in a current Claude Desktop version with extension support, or drag it into Settings → Extensions. Claude Desktop supplies the Python runtime.
  2. Keep “Paper trading” checked.The default setup simulates orders against the live book. Leave the wallet key empty while exploring.
  3. Check the connection.Ask Claude to call server_info, confirm dry_run: true and show the configured spending limits.

Use your own Claude access. Keep the app and computer running while using the local tools.

02

Bring your strategy into the conversation

In the builder, choose strategies, select markets and set your requested limits. Choose “My own agent”, then continue to Claude Desktop setup.

Save your draftCopy the briefReview with Claude

The brief preserves your selected outcome IDs, settings and notes. It asks Claude for read-only analysis. Your draft remains saved in that browser.

A brief is a specification.

Installing the extension or copying the brief does not start an automatic strategy, install its risk rules or authorize an order. Local trading needs separate setup and approval.

03

Choose the idea you want to explore

These are the strategy settings available in the builder. Claude can review their requirements using the local tools.

Quote both sides
Propose a buy quote on each selected outcome. Set shares per outcome and the distance below its midpoint in cents.
Fade sharp moves
Look for a recent price jump with historical evidence of reversion. Set a minimum move and lookback period.
High-probability outcomes
Review outcomes inside your entry-price range, with resolution criteria and remaining upside checked.
Trade my forecast
Compare your stated probability with market prices. Set the minimum edge and sizing fraction.
Follow momentum
Review moves above your threshold over the selected lookback, subject to volume and spread checks.

Price and share size are different: 20 shares at $0.48 have $9.60 of notional before fees. Animations illustrate the rules; they are not live signals or performance forecasts.

04

Understand each connection

Website sign-in
A wallet signature verifies ownership for your OddsRail session. It does not authorize an agent to trade.
Trading-account connection
Authenticated exchange reads can show cash, approvals and orders. Public holdings alone do not tell you what is available to spend.
Local signing
The desktop extension uses the signer key for your existing compatible Polymarket account. Website sign-in does not configure this local connection.

Trading-account and signer addresses may differ. Use the account belonging to your signer; an unrelated wallet address will not give it access.

05

Set up local trading deliberately

  1. Prepare your Polymarket account.Use an existing compatible account with funds and trading approvals already set up. The installer does not create or fund one for you.
  2. Configure the extension locally.Enter the matching signer private key and trading account's public wallet address in the extension settings. Never put a private key in a chat or on this website.
  3. Review controls and the proposed order.Check the local caps below. Ask Claude to inspect the exact market, outcome, side, price and shares, and run quote_cost and check_order.
  4. Enable live mode only when ready.Deliberately uncheck “Paper trading”, confirm the new mode with server_info, and separately approve the live order in your client.

check_order is a separate review tool; it is not automatically called by every order submission. A successful check does not place or authorize an order.

06

Know what the limits measure

Installer default · per order$25

Maximum notional for one order. Checked in simulation and live mode.

Installer default · per process$100

Cumulative submitted live-order notional in this local server process.

Restarting the extension resets the session counter. It is not a daily loss limit, an account-wide budget or a cap shared across multiple installations.

The builder's allocated capital, stop loss, daily loss rule and position limits remain requested settings. Copying a brief does not turn them into enforced local controls.

Environment settings for other MCP clients

These guards are optional outside the desktop installer. Configure them in your local environment and confirm the active values with server_info.

ODDSRAIL_MAX_ORDER_NOTIONAL
Per-order notional cap.
ODDSRAIL_MAX_SESSION_NOTIONAL
Cumulative submitted live-order notional for this process.
ODDSRAIL_ALLOWED_MARKETS
Comma-separated exact Polymarket outcome token IDs. The builder does not install this allowlist.
ODDSRAIL_MAX_OPEN_ORDERS
Maximum resting orders, checked against the live account. This counts orders, not held positions.
07

Hosted agents are not available yet

Website activation still needs session-key access and the completed trading integration. A saved draft, wallet sign-in or readiness check does not activate it.

The available path today is supervised use of the local Claude tools. It does not keep a website strategy running in the background.

08

Find your next step

Claude does not show the OddsRail tools

Check that the extension is installed and enabled in Claude Desktop, then open a new chat. If the installer is not recognized, update to a Claude Desktop version with MCPB/uv support. Use server_info to confirm the server responds.

I only see simulated orders

This is the default. Leave it enabled while reviewing the setup. For real orders, complete local trading setup and verify the resulting dry_run value. Website wallet sign-in does not change the extension's mode.

My cash or trading account cannot be verified

Check that the configured account address belongs to the signer and that its Polymarket setup is complete. An unavailable value is not a zero balance. In simulation, ask for paper_positions to inspect the local simulated portfolio.

An order was blocked or its result is unknown

Read the returned reason and keep the guard in place. If acceptance is unconfirmed, do not submit the same order again automatically. Reconcile open_orders and my_fills; use order_status when an order ID is available.

Market data works, but trading does not

Public data access does not establish trading eligibility, funding or permissions. Inspect the reported error and server_info. Venue restrictions still apply; read access is not proof that orders are allowed.

Still stuck? Open a support issue with your version and the error. Remove keys, credentials and other sensitive details.

09

Developer resources

For your own MCP client, install the Python package and launch oddsrail as a local stdio server. Python 3.11 or newer is required.

pip install oddsrail==0.18.1
claude mcp add --transport stdio oddsrail -- oddsrail

Review begins with server_info, find_markets(query, venues="polymarket"), get_market, quote_cost and check_order. Reading a market and submitting an order are separate operations.