question-market
Allows AI agents to interact with question.market prediction markets on the Algorand blockchain, including browsing markets, trading shares, and creating markets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@question-market Show me active prediction markets with probabilities"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@questionmarket/mcp
MCP server for question.market prediction markets on Algorand.
The minimal config gives agents read access plus wallet onboarding. To enable trading and market creation outside the monorepo, you also need the deployment app IDs and USDC ASA ID.
Quick start
Read-only + onboarding
All env vars have sensible defaults (public indexer, public testnet algod, public faucet), so the minimal install needs no env block. This enables market browsing, holdings lookups, wallet creation, set_wallet, faucet requests, and ALGO balance checks.
Claude Code
claude mcp add --transport stdio --scope user \
question-market -- npx -y @questionmarket/mcpCodex
codex mcp add question-market -- npx -y @questionmarket/mcpJSON config
{
"mcpServers": {
"question-market": {
"command": "npx",
"args": ["-y", "@questionmarket/mcp"]
}
}
}Override any of INDEXER_URL, ALGOD_SERVER, ALGOD_PORT, or ALGOD_TOKEN only if you need to point at a different endpoint.
Related MCP server: CryptoConduit-MCP
Enable Trading And Create-Market
The published package ships with the current testnet deployment bundled. When ALGOD_SERVER points at a testnet endpoint (the default), the server auto-loads FACTORY_APP_ID, PROTOCOL_CONFIG_APP_ID, and USDC_ASA_ID from that bundle — you do not need to set them manually.
The only thing you still need to add for write tools is a signer:
AGENT_MNEMONIC— 25-word mnemonic preloaded at startup (best for unattended / CI use)Runtime
set_wallet(mnemonic)— overridesAGENT_MNEMONICfor the current session; use this aftercreate_walletLocalnet KMD fallback — only applies when neither of the above is set and you are pointing at a local sandbox
Example (testnet, with preloaded mnemonic):
{
"mcpServers": {
"question-market": {
"command": "npx",
"args": ["-y", "@questionmarket/mcp"],
"env": {
"AGENT_MNEMONIC": "your twenty five word mnemonic goes here ..."
}
}
}
}Network selection. By default the server looks at ALGOD_SERVER to pick the bundled deployment (mainnet, testnet, or localnet). Override with QUESTION_MARKET_NETWORK=testnet|mainnet|localnet or point at a custom deployment file with QUESTION_MARKET_DEPLOYMENT_PATH. Env vars (USDC_ASA_ID, FACTORY_APP_ID, PROTOCOL_CONFIG_APP_ID) always win over the bundle.
Localnet. Run algokit localnet start, deploy the SDK (npm run deploy:localnet inside sdk/), and the resulting protocol-deployment.json will be auto-discovered. Alternatively, set QUESTION_MARKET_DEPLOYMENT_PATH=/absolute/path/to/protocol-deployment.json.
Verify it works
Ask your agent:
List five active question.market markets and show their current implied probabilities.
If you enabled write config, you can also ask:
Create a wallet, fund it on testnet, and buy $5 of outcome 0 in market 123.
Available tools
Read tools:
list_marketsget_marketget_price_historyget_market_tradesget_market_positionsget_positionsget_current_holdingsget_leaderboard
Onboarding tools:
create_walletset_walletrequest_testnet_tokensget_balance
Write tools:
buy_sharessell_sharesrefund_sharesclaim_winningsenter_lp_activeclaim_lp_feeswithdraw_lp_feesclaim_lp_residualcreate_market
The server only registers write tools when the required env vars are configured.
Environment variables
Variable | Required | Description |
| No | question.market API endpoint. Default: |
| No | Algorand node URL. Default: |
| No | Algorand node port. Default: |
| No | Algorand node auth token. Default: empty (correct for Nodely) |
| No (auto from bundle) | USDC ASA ID. Required for trading, LP, claims, refunds, and USDC-aware balances. Auto-loaded from the bundled deployment matching |
| No (auto from bundle) | MarketFactory application ID. Required for |
| No (auto from bundle) | ProtocolConfig application ID. Required for |
| No | 25-word mnemonic preloaded as the signer for write tools. Overridden by a runtime |
| No | Override the faucet endpoint for |
| No | Optional basic-auth credentials for self-hosted indexers |
| No | Optional bearer token used only by |
| No | Force network selection ( |
| No | Override path to a |
| No | Same as above, used by some deploy scripts that write to a separate output path |
| No | LocalNet KMD URL. Default: |
| No | LocalNet KMD port. Default: |
| No | LocalNet KMD token. Default: 64 × |
Built on
@questionmarket/sdk -- TypeScript SDK for question.market contracts
Model Context Protocol -- open standard for AI tool access
License
MIT
Available Tools
13 toolscreate_walletA
Generate a new Algorand account. Returns address and mnemonic. Call set_wallet with the mnemonic to activate it for trading.
Inputs: no named parameters.
get_balanceA
Check ALGO and tUSDC balance for an address. Defaults to the active session wallet if address is omitted.
Inputs: address.
get_current_holdingsA
Get a wallet's current holdings with per-market positions, LP stakes, marked value, and claimable resolved exposure.
Inputs: address (required).
get_leaderboardA
Get the leaderboard: wallets ranked by realized trading PnL from closed positions.
Inputs: no named parameters.
get_marketA
Get detailed market state: prices, pool, outcomes, deadline, resolution status.
Inputs: app_id (required).
get_market_positionsC
Get all user positions in a specific market.
Inputs: app_id (required).
get_market_tradesC
Get recent trades for a market.
Inputs: app_id (required), limit.
get_positionsA
Get all positions for a wallet address across all markets.
Inputs: address (required).
get_price_historyC
Get historical price snapshots for charting.
Inputs: app_id (required), limit.
list_marketsA
List prediction markets. Filter by status: 0=CREATED, 1=ACTIVE, 2=RESOLUTION_PENDING, 3=RESOLUTION_PROPOSED, 4=CANCELLED, 5=RESOLVED, 6=DISPUTED
Inputs: status.
question_marketA
Overview of the question.market MCP server: available tools, onboarding flow, and links.
Inputs: no named parameters.
request_testnet_tokensA
Fund the active session wallet (or a specified address) with testnet ALGO and tUSDC in one call. When the address is omitted or matches the active session wallet, the MCP also signs the tUSDC opt-in automatically and calls the faucet a second time so the wallet ends up with both ALGO and tUSDC. ALGO drips are capped at one per wallet / IP every 24 hours; tUSDC at one per wallet every hour. If a third-party address is passed, the MCP can only request the ALGO drip and returns optIn:true — that wallet's owner must sign the opt-in themselves.
Inputs: address.
set_walletA
Activate a wallet for this MCP connection. All write tools will sign with this account until the connection closes or set_wallet is called again. Overrides the wallet_index parameter on all tools. No restart needed.
Inputs: mnemonic (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct function: market browsing (list, get, trade history, price history), positions (all, per market, holdings), wallet management (create, set, fund, balance), info, and leaderboard. No two tools have overlapping purposes.
All tool names follow a consistent snake_case verb_noun pattern (e.g., get_current_holdings, list_markets, create_wallet). No mixing of styles or vague verbs.
13 tools cover market operations, wallet management, and data retrieval without excess. The count is appropriate for a prediction market server's scope.
The tool surface lacks a critical 'trade' or 'place_order' tool. Users can view markets and positions but cannot execute trades, which is a core action for a prediction market. This leaves a significant gap in functionality.
Maintenance
Related MCP Connectors
Read-only MCP server for live Polymarket, Kalshi, Limitless odds; Manifold sentiment.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
MCP server for accessing Glypse's prediction market analytics and research.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
Related MCP Servers
- AlicenseCqualityCmaintenanceA comprehensive MCP server for tooling interactions(40+) and resource accessibility(60+) with Algorand blockchain, plus many useful prompts.100241 npm44MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents direct access to Polymarket Crypto prediction markets, enriched with live spot prices. Discover markets, analyze order books, paper trade strategies, track activity, and execute live trades — all through natural language.1AGPL 3.0
- AlicenseAqualityDmaintenanceMCP server for Polymarket prediction markets, enabling search, market details, pricing, and bet analysis through 6 tools, with optional authenticated trading via API key.6MIT
- AlicenseAqualityDmaintenanceMCP server for Alpha Arcade prediction markets on Algorand. Enables AI agents to browse markets, fetch orderbooks, place orders, manage positions, and trade on-chain prediction markets.2045 npm10MIT