Skip to content
MCP server

SwapHunt crypto market context

Pay-per-call crypto market data from Hyperliquid, paid in USDC via x402

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
API, CLI
Runs
Locally
Version
0.7.0
Listing updated
3 days ago

About SwapHunt crypto market context

SwapHunt crypto market context is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

SwapHunt's server exposes 30 market tools whose results are computed from Hyperliquid USDC-margined perpetuals: prices, BTC regime, chop detection, volatility, expected move, funding rates, Alt Season Index and anti-FOMO checks like pump age and green-candle streaks. It adds the Crypto Fear & Greed Index, a halving countdown and trading session and weekend liquidity.

Calls are paid in USDC on Base through the x402 protocol, from a wallet you control. Without X402_PAY=1 every tool is a dry run that only reports its price, and a spending cap per session defaults to $0.10. PAYTO_ALLOWLIST restricts which addresses the server may pay. Each tool description states its price, with individual calls listed between $0.001 and $0.015.

One tool, pm_fees, is free and local: it computes the exact fee for an order on Kalshi, Polymarket US or polymarket.com from each platform's published fee schedule.

Install

Run in a terminal

claude mcp add swaphunt-mcp --env PRIVATE_KEY='<PRIVATE_KEY>' -- uvx swaphunt-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "swaphunt-mcp": {
      "command": "uvx",
      "args": [
        "swaphunt-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "<PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "swaphunt-mcp": {
      "command": "uvx",
      "args": [
        "swaphunt-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "<PRIVATE_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "swaphunt-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "swaphunt-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "<PRIVATE_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "swaphunt-mcp": {
      "command": "uvx",
      "args": [
        "swaphunt-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "<PRIVATE_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "swaphunt-mcp": {
      "command": "uvx",
      "args": [
        "swaphunt-mcp"
      ],
      "env": {
        "PRIVATE_KEY": "<PRIVATE_KEY>"
      }
    }
  }
}

Configuration

  • X402_PAYSet to 1 to pay for calls. Without it every tool is a dry run that only reports the price.
  • PRIVATE_KEY_FILEPath to a file with the private key of a dedicated wallet holding a few dollars of USDC on Base
  • PRIVATE_KEYPrivate key of a dedicated wallet (alternative to PRIVATE_KEY_FILE)
  • MAX_SPEND_USDSpending cap per session in USD
  • PAYTO_ALLOWLISTComma-separated addresses the server may pay; any other payTo is refused before signing

Tools this server provides (21)

Taken from the project documentation; the running server may differ.

get_spending
Shows what the session has spent and the budget left.
pm_fees
Computes the trading fee for an order on Kalshi or Polymarket.
get_fear_greed
Crypto Fear & Greed Index with its label.
get_fear_greed_compare
Compares the index with earlier days.
get_fear_greed_history
Daily index values for up to 365 days.
get_halving
Halving countdown for BTC or LTC.
get_trading_session
Current trading session and its typical volatility.
get_weekend_liquidity
Weekend or low-liquidity window with a 0-100 score.
get_price
One asset's price, 24h change and volume.
get_prices
Prices for up to 20 assets in one call.
get_supported_assets
Lists assets the price tools can quote.
get_market_regime
BTC regime from price against the 12h EMA20.
get_chop_detection
Trending or chopping from ADX.
get_volatility
Realized volatility over 7, 14 or 30 days.
get_market_silence
Market-silence score from 0 to 1.
get_compression_alert
Volatility squeeze on 1h, 4h or 1d.
get_expected_move
ATR-based 68% and 95% ranges.
get_funding_rates
Current hourly funding for up to 20 coins.
get_top_funding_rates
Most positive or negative funding across perps.
get_funding_history
Hourly funding history for one coin.
get_alt_season
The SwapHunt Alt Season Index.

What it does

Dry-run by default
Tools only report their price until payment is switched on.
Session spending cap
Defaults to $0.10 per session.
Payee allowlist
Refuses to pay addresses not on the list.
Perpetuals analytics
Regime, volatility, funding and expected-move calculations.
Sentiment indicators
Fear & Greed index with comparisons and history.
Free prediction-market fees
Local fee calculator for Kalshi and Polymarket.

Good for

  • Check funding rates before sizing a position
  • Ask whether a move looks like a late breakout
  • Estimate the expected range for the day
  • Work out exact fees on a prediction market order

Pricing

Paid

Pay per call in USDC from $0.001; pm_fees free

Prices change. Check x402.swaphunt.dev before you buy.

SwapHunt crypto market context FAQ

How are calls paid?

In USDC on Base via x402 from a dedicated wallet whose key you supply.

How do I avoid overspending?

Keep `MAX_SPEND_USD` low (default 0.10 per session) and use `PAYTO_ALLOWLIST`.

Is anything free?

`get_spending` and `pm_fees` are free.

How do I run it?

`uvx swaphunt-mcp`, which needs uv.

Is SwapHunt crypto market context free?

No. SwapHunt crypto market context is a paid product.

How do I add SwapHunt crypto market context to Claude Code?

Run this command in your terminal: claude mcp add swaphunt-mcp --env PRIVATE_KEY='<PRIVATE_KEY>' -- uvx swaphunt-mcp

What are the best alternatives to SwapHunt crypto market context?

The closest alternatives to SwapHunt crypto market context are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to SwapHunt crypto market context

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments