MCP Integration

Connect MCP-compatible AI assistants to SatoriEx prediction markets

Connect Claude, Cursor, and other MCP-compatible assistants so they can read live market data and submit orders that you authorize through OAuth. You stay in control — every order is signed against your account permissions and trading limits.

Experimental

The MCP integration is under active development. The tool surface, transport (StreamableHTTP at /mcp, SSE at /mcp/sse), and OAuth flow may change without notice. Pin to a versioned client and watch the changelog before automating around it.

How It Works

Connect

Add the SatoriEx MCP endpoint to your AI assistant's configuration and sign in with OAuth.

Discover

The assistant automatically discovers the tools it can use — list markets, read prices, place orders.

Trade

Ask in plain language. Every order the assistant submits is signed under your account and gated by your KYC tier limits.

Endpoint

Endpointhttps://staging.satoriex.io/mcp

ProtocolStreamableHTTP + SSE

AuthenticationOAuth 2.0

Available Tools

list_markets

Browse prediction markets with filters

get_market

Get market details and outcomes

get_orderbook

View current bids and asks

list_trades

Recent trade history

get_balanceRequires authentication

Check your platform balance

get_portfolioRequires authentication

Snapshot of balances, positions, and open orders

place_orderRequires authentication

Place buy/sell orders

get_positionsRequires authentication

View your open positions

get_ordersRequires authentication

View your active orders

cancel_orderRequires authentication

Cancel an open order

propose_marketRequires authentication

Submit a new market proposal — requires markets:propose scope

list_proposalsRequires authentication

List your submitted proposals — requires markets:propose scope

approve_proposalRequires authentication

Approve a pending proposal — admin:proposals scope

reject_proposalRequires authentication

Reject a pending proposal (refunds $1 fee) — admin:proposals scope

settle_marketRequires authentication

Trigger payouts after resolution — admin:settlement scope

Quick Start

mcp.json

{
  "mcpServers": {
    "satoriex": {
      "url": "https://staging.satoriex.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Admin scopes are not available on PATs or OAuth apps

The admin:settlement scope is restricted to session JWTs issued to super_admin accounts. It cannot be granted to Personal Access Tokens or OAuth application clients. Tools that require this scope (settle_market) will only work when invoked from a Claude session authenticated as a super_admin user.

Compatible Clients

Claude Desktop

Claude Code

Cursor

Any MCP-compatible AI assistant