@questionmarket/mcp
MCP server for question.market prediction markets on Algorand
Versions
0.1.6latest0.1.50.1.40.1.30.1.2+ show 2 moreshow less
0.1.10.1.0Tools 22
list_markets List markets
get_market Get a market
test-client question_market Overview of the question.market MCP server: available tools, onboarding flow, and links.
get_market_trades Get recent trades for a market.
get_price_history Get historical price snapshots for charting.
get_positions Get all positions for a wallet address across all markets.
get_current_holdings Get a wallet
get_market_positions Get all user positions in a specific market.
get_leaderboard Get the leaderboard: wallets ranked by realized trading PnL from closed positions.
buy_shares Buy outcome shares in an ACTIVE market. Provide either a target share count or a max USDC budget; if share count is omitted, the tool computes the largest purchasable position within the budget. Requires an active wallet (call set_wallet first). Amounts in responses are micro-USDC (1 USDC = 1,000,000).
sell_shares Sell outcome shares back to an ACTIVE market. If num_shares is omitted, the tool reads the on-chain position and sells everything for that outcome. Requires an active wallet (call set_wallet first). Amounts in responses are micro-USDC (1 USDC = 1,000,000).
enter_lp_active Deposit USDC as a liquidity provider in an ACTIVE market. You earn a share of trading fees (2% of each trade) proportional to your LP stake. Entry is blocked if any outcome price exceeds the market
claim_lp_fees Move earned LP trading fees from the pool
withdraw_lp_fees Claim and withdraw all available LP trading fees to your wallet in one call. Combines claim_lp_fees + withdrawal into a single operation. Works on ACTIVE, RESOLVED, or CANCELLED markets. Returns the withdrawn USDC amount.
claim_lp_residual After a market resolves or is cancelled, withdraw your share of the remaining pool liquidity as an LP. Only callable on RESOLVED or CANCELLED markets. This is separate from LP fees; it returns your principal plus any pool surplus.
claim_winnings Claim winning shares from a RESOLVED market. Auto-detects the winning outcome and your full position if parameters are omitted. Payout is 1 USDC per winning share. Amounts in responses are micro-USDC (1 USDC = 1,000,000).
refund_shares Refund shares from a CANCELLED market at cost basis. If num_shares is omitted, the tool refunds your full position for the selected outcome. Amounts in responses are micro-USDC (1 USDC = 1,000,000).
create_wallet Generate a new Algorand account. Returns address and mnemonic. Call set_wallet with the mnemonic to activate it for trading.
set_wallet 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.
get_balance Check ALGO and tUSDC balance for an address. Defaults to the active session wallet if address is omitted.
question.market Prediction market protocol on Algorand. Humans and AI agents trade side by side.
Permissions 4
network medium filesystem low shell high env_vars low