ProFunding MCP Server

Trade funding rate arbitrage across 20+ perpetual DEXes from your AI assistant — find opportunities, open delta-neutral positions, supervise them to optimal exit. Backed by ProFunding.

Quick start

pip install profunding-mcp
claude mcp add profunding profunding-mcp -e PROFUNDING_API_KEY=pfk_your_key_here

Free API key at profunding.pro. Market-data tools work without one.

Setup

About the API key

Most tools (trading, account, find-exit, deep analytics) need an API key. Keys are free at profunding.pro — sign up takes seconds, no credit card. Market-data and backtest tools work without one.

Claude Code without a key (market-data only)

claude mcp add profunding profunding-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "profunding": {
      "command": "profunding-mcp",
      "env": {
        "PROFUNDING_API_KEY": "pfk_your_key_here"
      }
    }
  }
}

Environment Variables

Variable Required Description
PROFUNDING_API_KEY For most tools Free key from profunding.pro. Trading, account, find-exit, and deep analytics need one; market-data tools work without one.

Auto-approve trade tools (Claude Code)

Claude Code asks for confirmation before each call to a trade tool. To approve them once per project, add the trade allowlist to .claude/settings.local.json in that project's root (or ~/.claude/settings.json for global):

{
  "permissions": {
    "allow": [
      "mcp__profunding__open_trade",
      "mcp__profunding__close_trade",
      "mcp__profunding__cancel_order",
      "mcp__profunding__open_delta_neutral",
      "mcp__profunding__close_delta_neutral",
      "mcp__profunding__convert_stablecoin",
      "mcp__profunding__twap_open_dn",
      "mcp__profunding__twap_close_dn",
      "mcp__profunding__twap_cancel"
    ]
  }
}

Note: Claude's built-in safety policies may still decline crypto trading actions even with the allowlist in place — the allowlist clears permission prompts, not Claude's own safety check on financial actions. If trades get declined, phrase the request as an explicit authorization (e.g. "I authorize a $5 long ETH on Lighter via open_trade. Execute now.") or use Claude Code's plan mode.

Tools (44)

The Auth column shows whether a tool needs an API key:

  • open — public, no key needed
  • key — needs a free API key (wallet-bound for find-exit / trading)

Market Data & Discovery (12, all open)

Tool Auth Description
get_opportunities open Live funding rate arbitrage opportunities across all DEXes
get_exchanges open List connected DEXes with status and funding interval
get_historical_rates open Historical funding rates for a symbol on one exchange
get_rate_chart_data open Funding rate spread over time between two exchanges
get_price_spread_data open Mark price divergence between two exchanges (price risk analysis)
run_backtest open Backtest a delta-neutral trade with real historical data
analyze_pair open Full end-to-end analysis: funding + backtest + risk + depth on both legs + price spread
compare_exchanges open Side-by-side comparison of same symbol across exchanges: rates, spread, depth, volume
find_best_trade open Best trade you can open right now at your position size — ranked by net APR after fees, liquidity, and risk
get_smart_opportunities open Opportunities ranked by how tradable they actually are — APR, depth, and stability combined
get_pair_intelligence open Risk scores, backtested APR, smart ranking, depth tiers for all pairs
check_liquidity open Real-time order book depth + slippage estimates at $1k/$5k/$10k

Deep Analytics (7, key required)

Tool Auth Description
get_live_alpha key Top 5 deduplicated opportunities
get_still_paying key Pairs above 50% APR for 24h+ still active now
get_top_holders key Pairs holding high APR the longest
get_momentum_movers key Biggest funding spread jumps in last 6 hours
get_unbroken_streaks key Consecutive hours above APR threshold
get_record_roi key Best single trade by ROI in a period
get_weekly_recap key Best ROI pair, best DEX combo, most stable pair

Trading (5, key required)

Tool Auth Description
open_trade key Open a single-leg position on one DEX — market, or a resting limit order (order_type="limit" + limit_price, all tradable DEXes)
close_trade key Close a single-leg position on one DEX — market, or a resting reduce-only limit close (limit_price, all tradable DEXes)
open_delta_neutral key Open a delta-neutral pair: long one DEX, short another (market)
close_delta_neutral key Close both legs of a delta-neutral pair (market)
convert_stablecoin key Convert between USDC / USDT / other stablecoins where supported

Limit Orders (3, key required)

Resting limit orders on all tradable DEXes (aster, hyperliquid + HIP-3 sub-DEXes, lighter, pacifica, hibachi, extended, nado, grvt, 01xyz, variational, ethereal, hotstuff, risex). A limit order from open_trade returns immediately with status="open" and an order id; manage it with these. Extended, nado, grvt, ethereal and risex honor post_only. Per-DEX cancel id: most DEXes' open_trade order id is cancellable directly; Lighter resting orders must be located via get_open_orders first — its open_trade response is a tx hash, not a cancellable id, so list-then-cancel.

Tool Auth Description
get_open_orders key List your resting limit orders on a DEX (Lighter requires a symbol; its returned id is what cancel_order needs)
cancel_order key Cancel a resting limit order by its cancellable order id
get_order_fills key Check whether a limit order filled and finalize builder-fee accounting (pass the trade_log_id from open_trade)

TWAP (5, key required)

Backend-orchestrated TWAP that slices a delta-neutral open or close over time with per-slice slippage protection. Runs server-side (no client needed) — start it, then poll. Supported DEXes: hyperliquid, extended, pacifica, aster, lighter, grvt, hibachi, ethereal, o1xyz, nado, variational (+ HIP-3).

Tool Auth Description
twap_open_dn key Gradually OPEN a delta-neutral pair (margin-sized) — slices into both legs over a time window
twap_close_dn key Gradually CLOSE a delta-neutral pair — slices both legs out over a time window
twap_job_status key Status + progress of a TWAP job (open or close)
twap_cancel key Stop a running TWAP job at the next slice boundary (filled slices are not rolled back)
twap_jobs key List your recent TWAP jobs (open + close)

Account (3, key required)

Tool Auth Description
get_positions key List your open positions across all DEXes with credentials stored
get_balance key Read account balances from each connected DEX
get_alerts key Position alerts and monitoring events triggered for your wallet

Credentials (4, key required)

Tool Auth Description
store_credentials key Save API keys / signer keys for a DEX (encrypted server-side)
list_credentials key List which DEXes have credentials stored, with last-verified status
revoke_credentials key Remove stored credentials for one DEX
revoke_all_credentials key Remove all stored credentials

Find Exit (4, key required)

Optimal-exit search for an open delta-neutral position. Backend monitors the spread peak and exits when conditions confirm the trade has stopped paying.

Tool Auth Description
find_exit_preview key Preview what an optimal exit would look like for a position (peak/target/current)
find_exit_start key Start a find-exit job on a position with target APR / max wait constraints
find_exit_status key Read current state of a find-exit job (anchor, peak, drawdown, ticks)
find_exit_cancel key Cancel an active find-exit job and leave the position open

Monitoring (1, key required)

Tool Auth Description
watch_position key Set up alert thresholds for a position (drawdown, funding sign flip, etc) — fires via Telegram

Example Queries

Once connected, ask your AI assistant:

Discovery & analysis (work without a key)

  • "What's the best trade I can open right now with $5k?"
  • "Analyze ETH/USDC on Extended vs Aster — is it worth entering?"
  • "Compare ETH funding rates across Hyperliquid, Aster, and Extended"
  • "Check liquidity for SOL on Pacifica — can I fill $10k?"
  • "Run a 30-day backtest on BTC long Lighter short Hyperliquid"

Trading (need a key)

  • "Open a $200 delta-neutral on ETH: long Hyperliquid, short Aster"
  • "What positions do I have open?"
  • "Close my BTC delta-neutral pair"
  • "Find the optimal exit for my SOL/USDC position with a 50% target APR"
  • "Place a resting limit buy of $50 ETH on Aster at 3000, then show my open orders"
  • "TWAP into a $1000 delta-neutral on SOL (long Lighter, short Aster) over 20 minutes, then check the job status"

Credentials (need a key)

  • "Store my Hyperliquid API key — I'll paste the wallet and signer below"
  • "Which DEXes do I have credentials for?"

Get a Key

Visit profunding.pro to claim your free API key. Bound to your wallet so trading and find-exit can sign and route orders on your behalf.