Kalshi MCP Server

@quantish/kalshi-server

⚠️ Notice: Quantish is winding down. The Quantish platform (quantish.live) is shutting down. This MCP server is self-hosted and will continue to work independently, but the Quantish team will no longer be maintaining or updating this project. If you're building in the prediction market space and need real-time data infrastructure, check out polynode.dev.

Self-hosted Kalshi MCP server for trading on Kalshi markets via DFlow on Solana.

Overview

This package provides an MCP (Model Context Protocol) server that enables AI agents to trade on Kalshi prediction markets through the DFlow protocol on Solana.

Features

• Full Kalshi Trading - Buy/sell on any Kalshi market
• Solana Wallet Management - Generate and manage Solana wallets
• DFlow Integration - Trade via DFlow's Solana infrastructure
• Jupiter Swaps - Swap SOL/USDC via Jupiter Aggregator
• MCP Compatible - Works with Claude, Quantish Agent, and any MCP client
• Self-Hostable - Run on Railway, Fly.io, or any Node.js host

Quick Start

git clone https://github.com/joinQuantish/kalshi-mcp
cd kalshi-mcp
npm install

Environment Variables

Obtaining API Keys

DFlow API Key:

DFlow access may require approval. Contact the DFlow team at dflow.net for API access.

Jupiter API Key:

Get a free API key from portal.jup.ag (Basic tier, 1 RPS). Required for swap functionality.

Using Quantish's public servers? Quantish's public servers are no longer available as the platform is winding down. You must self-host this MCP server to use it. Follow the setup instructions above to run your own instance.

Generate Encryption Key

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Database Setup

Any PostgreSQL database works. Options:

Set your DATABASE_URL then run:

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

Available Tools

Account Management

• kalshi_signup - Create account with Solana wallet
• kalshi_request_api_key - Request API key with access code
• kalshi_get_wallet_info - Get wallet address and type
• kalshi_get_wallet_status - Full wallet status including balances
• kalshi_get_balances - Get SOL and USDC balances
• kalshi_get_deposit_address - Get address for deposits
• kalshi_export_private_key - Export wallet private key
• kalshi_import_private_key - Import existing Solana wallet

Market Discovery

• kalshi_search_markets - Search Kalshi markets by keyword
• kalshi_get_market - Get market details by ticker
• kalshi_get_event - Get event with all nested markets
• kalshi_get_events - Browse events with filters
• kalshi_get_live_data - Get live pricing data

Trading

• kalshi_get_quote - Get quote for prediction market trade
• kalshi_buy_yes - Buy YES outcome tokens
• kalshi_buy_no - Buy NO outcome tokens
• kalshi_sell_position - Sell outcome tokens back to USDC
• kalshi_get_positions - View current positions
• kalshi_get_orders - View order history

Swaps (SOL/USDC)

• kalshi_get_swap_quote - Get Jupiter swap quote
• kalshi_execute_swap - Execute token swap
• kalshi_swap_sol_to_usdc - Swap SOL to USDC
• kalshi_swap_usdc_to_sol - Swap USDC to SOL

Transfers

• kalshi_send_sol - Send SOL to another wallet
• kalshi_send_usdc - Send USDC to another wallet
• kalshi_send_token - Send any SPL token

Market Operations

• kalshi_check_market_initialization - Check if market is tokenized on-chain
• kalshi_initialize_market - Initialize market on-chain (pays SOL fee)
• kalshi_check_redemption_status - Check if market is settled
• kalshi_get_market_by_mint - Look up market by token mint

Redemption

• kalshi_get_redeemable_positions - Find positions ready to claim
• kalshi_redeem_winnings - Redeem specific winning position
• kalshi_redeem_all_positions - Redeem all winning positions at once

API Key Management

• kalshi_list_api_keys - List your API keys
• kalshi_create_additional_api_key - Create new API key
• kalshi_revoke_api_key - Revoke an API key

API Format

The server exposes a JSON-RPC 2.0 endpoint at /mcp:

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "kalshi_get_positions",
      "arguments": {}
    },
    "id": 1
  }'

Connecting to Quantish Agent

Configure the CLI to use your server:

export KALSHI_MCP_URL=https://your-server.com/mcp
export KALSHI_API_KEY=your-api-key
quantish

Or add to ~/.quantish/config.json:

{
  "kalshiMcpUrl": "https://your-server.com/mcp",
  "kalshiApiKey": "your-api-key"
}

Development

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

Resources

• NPM: @quantish/kalshi-server
• GitHub: joinQuantish/kalshi-mcp
• Quantish Agent: @quantish/agent
• DFlow Docs: pond.dflow.net
• Jupiter Portal: portal.jup.ag

License

This project is licensed under the PolyForm Noncommercial License 1.0.0.

Free for personal use, research, and non-commercial purposes. Commercial use requires explicit permission from Quantish Inc. Contact [email protected] for commercial licensing.

Built by Quantish Inc.