DOCUMENTATION
Get started with OddsRail.
Set up OddsRail, understand your strategy and stay in control of what trades.
Start with Claude Desktop
OddsRail gives Claude tools to read Polymarket markets, review proposed orders and trade from your computer after you configure access.
- Install the extension.Open the
.mcpbfile in a current Claude Desktop version with extension support, or drag it into Settings → Extensions. Claude Desktop supplies the Python runtime. - Keep “Paper trading” checked.The default setup simulates orders against the live book. Leave the wallet key empty while exploring.
- Check the connection.Ask Claude to call
server_info, confirmdry_run: trueand show the configured spending limits.
Use your own Claude access. Keep the app and computer running while using the local tools.
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.
The brief preserves your selected outcome IDs, settings and notes. It asks Claude for read-only analysis. Your draft remains saved in that browser.
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.
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.
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.
Set up local trading deliberately
- 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.
- 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.
- 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_costandcheck_order. - 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.
Know what the limits measure
Maximum notional for one order. Checked in simulation and live mode.
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.
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.
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.
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
Order books, fills, rejected orders and other venue integration details.
Source & tool referenceCode, configuration reference and examples for your integration.
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.