Thetanuts MCP Server
Read-only MCP (Model Context Protocol) server for the Thetanuts SDK.
Features
This server is READ-ONLY. It does NOT:
Execute transactions
Handle private keys
Perform any state-changing operations
Available Tools
Indexer API Tools (OptionBook data)
get_stats
Protocol statistics (from Indexer API)
get_user_positions
User's option positions (from Indexer API)
get_user_history
User's trade history (from Indexer API)
get_referrer_stats
Aggregated stats for a referrer address (from Indexer API)
State/RFQ API Tools
get_rfq
Get specific RFQ by ID (from State/RFQ API)
get_user_rfqs
User's RFQ history (from State/RFQ API)
Market & Orders
get_market_data
Current prices for BTC, ETH, SOL, etc.
get_market_prices
All supported asset prices
fetch_orders
All orders from the orderbook
filter_orders
Filter orders by asset/type/expiry
Token & Option Data
get_token_balance
Token balance for address
get_token_allowance
Token allowance for spender
get_token_info
Token decimals and symbol
get_option_info
Option contract details
calculate_option_payout
Calculate payout for an option at settlement price
preview_fill_order
Preview order fill (dry-run)
Utilities
calculate_payout
Calculate payoff for structures
convert_decimals
Convert to/from chain decimals
get_order_fill_events
Historical fill events
get_chain_config
Chain contracts and tokens
MM Pricing
get_mm_all_pricing
Get all MM-adjusted pricing for an asset
get_mm_ticker_pricing
Get MM pricing for a specific ticker
get_mm_position_pricing
Get position-aware MM pricing with collateral cost
get_mm_spread_pricing
Get MM pricing for a two-leg spread
get_mm_condor_pricing
Get MM pricing for a four-leg condor
get_mm_butterfly_pricing
Get MM pricing for a three-leg butterfly
RFQ Quotation Tools
get_quotation
Get detailed quotation info by ID including parameters and current state
get_quotation_count
Get total number of quotations created
get_user_offers
Get all RFQ offers made by a user
get_user_options
Get all options held by a user
encode_settle_quotation
Encode settlement transaction for an RFQ after reveal phase (returns tx data)
encode_settle_quotation_early
Encode early settlement to accept a specific offer before offer period ends
encode_cancel_quotation
Encode cancellation transaction for an RFQ (requester only)
encode_cancel_offer
Encode offer cancellation transaction (offeror only)
RFQ Builder Tools
build_rfq_request
Build RFQ request parameters for vanilla PUT or CALL option
build_spread_rfq
Build RFQ request for a two-leg spread (put spread or call spread)
build_butterfly_rfq
Build RFQ request for a three-leg butterfly
build_condor_rfq
Build RFQ request for a four-leg condor (all calls or all puts)
build_iron_condor_rfq
Build RFQ request for a four-leg iron condor (put spread + call spread)
build_physical_option_rfq
Build RFQ request for physical-settled vanilla PUT or CALL
encode_request_for_quotation
Encode RFQ creation transaction from built request parameters
Calculation Tools
calculate_num_contracts
Calculate number of contracts from trade amount
calculate_collateral_required
Calculate collateral required for a position in USDC
calculate_premium_per_contract
Calculate premium per contract in USD from MM price
calculate_reserve_price
Calculate total reserve price (minimum acceptable premium)
calculate_delivery_amount
Calculate delivery amount for physical options
calculate_protocol_fee
Calculate protocol fee for an RFQ trade
Validation Tools
validate_butterfly
Validate butterfly option strike configuration (3 strikes with equal wing widths)
validate_condor
Validate condor option strike configuration (4 strikes with equal spread widths)
validate_iron_condor
Validate iron condor strike configuration (put spread below, call spread above)
validate_ranger
Validate ranger (range) option strike configuration (2 strikes)
Chain Configuration Tools
get_chain_config_by_id
Get full chain configuration by chain ID
get_token_config_by_id
Get token configuration (address, decimals) by chain ID and symbol
get_option_implementation_info
Get all option implementation addresses and deployment status
generate_example_keypair
Generate an example ECDH keypair (for demonstration only)
Option Query Tools
get_full_option_info
Get comprehensive option information including all strikes, positions, and settlement status
get_position_info
Get position information for buyer or seller of an option
parse_ticker
Parse an option ticker string (e.g., "ETH-16FEB26-1800-P") into its components
build_ticker
Build an option ticker string from components
Event Query Tools
get_option_created_events
Get historical option creation events
get_quotation_requested_events
Get historical RFQ quotation requested events
get_quotation_settled_events
Get historical RFQ quotation settled events
get_position_closed_events
Get historical position closed events for a specific option contract
Encoding Tools (Transaction Builders)
encode_fill_order
Encode a transaction to fill an order from the orderbook
encode_approve
Encode a token approval transaction
Note: Encoding tools return transaction data for wallet signing - they do NOT execute transactions.
Installation
Usage
With Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
With Clawdbot
Add to your .mcp.json:
Development
Environment Variables
THETANUTS_RPC_URL
https://mainnet.base.org
RPC endpoint
Examples
Get Market Data
Filter ETH Calls
Get MM Pricing
Get RFQ Quotation
Encode Settlement Transaction
Note: Use the returned to and data with your wallet to sign and send the transaction.
License
MIT
Last updated