Skip to main content
Glama
Funding-mcp

Funding-mcp

Official
by namixai

@usenami/funding-mcp

MCP server for multi-venue perpetual + HIP-3 market data — 20+ exchanges including Binance, Bybit, OKX, Hyperliquid, Aster, Lighter, and Hyperliquid HIP-3 sub-DEXes (stocks, metals, oil, forex, indices, pre-IPO synthetics) that CoinGecko / CMC / Coinglass don't aggregate.

Gives any MCP-capable AI agent a named, schema'd surface for funding, liquidity, positioning, flow, basis, and RWA data — backed by Usenami's live API. Pairs with @usenami/signer-mcp for keyless execution.

Tools

Tool

What it does

Cost

funding_screener

Current cross-venue funding rates (preview)

Free

funding_arb

Ranked cross-exchange funding-arb candidates

~$0.003

funding_signal

Decision-ready funding-arb signal: net-of-fees + breakeven + depth-sized max notional + liquidity flag

~$0.025

funding_spread

Per-symbol funding spread across venues

~$0.001

funding_history

Historical funding rates (backtesting)

~$0.005

orderbook_slippage

Multi-venue execution cost / slippage

~$0.005

open_interest

Current OI for ticker on venue

~$0.001

oi_delta

OI change over a lookback window

~$0.003

volume_24h

24h perp volume for ticker on venue

~$0.001

volume_anomalies

Anomalous volume spikes across venues

~$0.003

oracle_families

Oracle-family / basis-risk map

~$0.001

rwa_coverage

HIP-3 RWA coverage (stocks/metals/oil)

~$0.001

Paid tools settle in USDC on Base via the x402 protocol. Set X402_PRIVATE_KEY (a Base wallet holding USDC) and the paid tools auto-pay and return data; without it they return the x402 payment requirements so any x402-capable client can pay and retry. funding_screener is free and needs no wallet.

Note: funding_arb is a naive scan (excludes fees, latency, and execution timing) — treat it as a candidate list, not trade advice.

Related MCP server: hyperd-mcp

Install

{
  "mcpServers": {
    "usenami-funding": {
      "command": "npx",
      "args": ["-y", "@usenami/funding-mcp"]
    }
  }
}

Optional env: USENAMI_API_BASE (default https://api.usenami.io); X402_PRIVATE_KEY (Base wallet 0x… with USDC — enables built-in auto-pay for the paid tools).

Support

Hit a problem or want data we don't cover yet? Report issues / request data: support@usenami.io · Partnerships: business@usenami.io · Telegram: @USnami.

Local dev

npm install
npm run build
npm start

MIT · usenami.io

Available Tools

12 tools
funding_arbA

Cross-exchange funding-rate ARBITRAGE candidates: ranked long/short venue pairs by funding spread (delta-neutral) across 20+ venues. Naive scan — excludes fees/latency/execution timing. PAID ~$0.003 via x402.

Inputs: min_diff, limit.

funding_historyA

Historical funding rates for a symbol across venues (for backtesting/analysis). PAID ~$0.005 via x402.

Inputs: ticker (required), aggr, from, to.

funding_screenerA

FREE preview of current cross-venue perpetual funding rates across 20+ exchanges (Binance, Bybit, OKX, Hyperliquid, Aster, Lighter, HIP-3 sub-DEXes). No wallet required.

Inputs: symbol.

funding_signalA

DECISION-READY funding-arb SIGNAL — the 'sell-the-outcome' upgrade over funding_arb. Ranked opportunities NET of public round-trip taker fees, with funding-periods-to-breakeven, a depth-sized max notional ($1k/$5k/$10k from real order-book depth) and a liquidity flag (deep/moderate/thin/below_1k). Computed facts, NOT a profit forecast. PAID ~$0.025 via x402.

Inputs: min_diff, limit.

funding_spreadB

Current funding-rate spread for one symbol across all venues (min/max venue, basis). PAID ~$0.001 via x402.

Inputs: symbol (required).

oi_deltaB

Open-interest change over a lookback window for a ticker on a venue (positioning shifts). PAID ~$0.003 via x402.

Inputs: ticker (required), venue (required), lookback_hours.

open_interestB

Current open interest for a ticker on a venue. PAID ~$0.001 via x402.

Inputs: venue (required), ticker (required).

oracle_familiesA

Oracle-family grouping across venues (which venues share an oracle → basis-risk map). PAID ~$0.001 via x402.

Inputs: no named parameters.

orderbook_slippageA

Multi-venue execution cost / slippage for a trade size — where a ticker is cheapest to execute across venues. PAID ~$0.005 via x402.

Inputs: ticker (required), size_usd.

rwa_coverageB

Hyperliquid HIP-3 RWA perpetual coverage — stocks, metals, oil, forex, indices, pre-IPO synthetics that CoinGecko/CMC/Coinglass do not aggregate. PAID ~$0.001 via x402.

Inputs: asset_class.

volume_24hB

24h perpetual volume for a ticker on a venue. PAID ~$0.001 via x402.

Inputs: venue (required), ticker (required).

volume_anomaliesA

Tickers showing anomalous volume spikes across venues (flow detection). PAID ~$0.003 via x402.

Inputs: lookback_hours, min_multiplier, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of perpetual funding market data: arbitrage screening, history, signal, spread, open interest, volume, orderbook, etc. Even closely related tools like funding_arb and funding_signal have clear differences in scope and detail.

    Naming Consistency5/5

    All tool names follow a consistent lowercase_snake_case pattern, primarily noun_noun (e.g., funding_arb, volume_24h) or adjective_noun (e.g., open_interest). The naming is predictable and descriptive, with no mixed conventions.

    Tool Count5/5

    With 12 tools, the server offers a well-scoped set that covers the core domain without being overwhelming or too sparse. Each tool earns its place by addressing a specific data need.

    Completeness5/5

    The tool surface covers key areas of perpetual funding analysis: funding rates (history, spread, signal, screen), open interest, volume, orderbook slippage, oracle risk, and RWA coverage. There are no obvious gaps for the intended use case of market data retrieval and analysis.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Real-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.
      15
      37 PyPI
      1
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      Perp-first funding rate & RWA spread data for AI agents. 30+ CEX/DEX venues, 6 tools (4 x402-paywalled, 2 free), bring-your-own-wallet via Base mainnet.
      6
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Trust layer for AI agents: 22 pay-per-call x402 tools for scam and fraud checks, payment pre-flight, wallet screening, policy approvals, contact extraction and company research. Free preview with no wallet; paid calls settle in USDC on Base.
      22
      332 npm
      MIT