@quantish/kalshi-server

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

| Variable | Required | Description | |----------|----------|-------------| | DATABASE_URL | Yes | PostgreSQL connection string | | ENCRYPTION_KEY | Yes | 64-character hex string for wallet encryption | | DFLOW_API_KEY | No | DFlow API key (optional, for authenticated endpoints) | | JUPITER_API_KEY | No | Jupiter API key from portal.jup.ag for swap tools | | SOLANA_RPC_URL | No | Solana RPC endpoint (defaults to mainnet) | | ADMIN_API_KEY | No | Admin API key for administrative endpoints | | PORT | No | Server port (defaults to 3002) |

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? You don't need your own keys - we handle this for you. Just use the default MCP endpoints provided by the Quantish Agent.

Generate Encryption Key

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

Database Setup

Any PostgreSQL database works. Options:

| Provider | Notes | |----------|-------| | Railway | Add PostgreSQL service, copy DATABASE_URL from variables | | Supabase | Free tier at supabase.com, copy connection string from Settings > Database | | Neon | Serverless Postgres at neon.tech, free tier available | | Local Docker | docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres |

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.