# SwapHunt crypto market context

> SwapHunt crypto market context is a paid MCP server for finance and payments. Pay-per-call crypto market data from Hyperliquid, paid in USDC via x402. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://x402.swaphunt.dev/docs
- **Repository:** https://github.com/swaphunt/x402-examples/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.swaphunt/swaphunt-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/swaphunt-crypto-market-context
