io.github.verixiaapps/hostdefi-x402

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Free token-safety scans + paid x402 verdicts, signals, radar & EVM swap quotes for AI agents.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "hostdefi-x402": {
      "url": "https://hostdefi.com/api/v1/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (15)

• scan_token read-only

  FREE. HostDeFi token-safety scan — pass any token contract address (Solana mint or EVM address), or an exact token name/ticker: structured risk read with concerning/legitimate on-chain signals (authority state, liquidity, holder concentration, contract flags). No payment, no signup — fair use 100 checks/day per IP (the same free scanner as https://hostdefi.com/scan).

  Parameters:

  • token (required) — string — token contract address / Solana mint, or an exact token name/ticker

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_x402_pricing read-only

  FREE. The HostDeFi machine-payable price catalog: every paid resource, its USD price and settlement rails.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• token_risk_verdict read-only

  PAID ($0.02/call). HostDeFi A+–F token safety verdict by chain + address: grade, score, verdict prose, liquidity/holders/authority signals. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chain (required) — string — solana, ethereum, base, arbitrum, …
  • address (required) — string — token contract address / mint
  • x402_payment — string — base64 X-PAYMENT payload (omit on the first call to get payment requirements)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• token_risk_deep read-only

  PAID ($0.25/call). Deep HostDeFi report in one call: the current A+-F verdict with authority/holder signals, the FULL dated safety history for the token, and a derived trend block (grade movement, liquidity trajectory, worst drawdown, days tracked). All figures are computed from recorded rows — no projections. History depth accrues from 2026-08-16. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chain (required) — string — solana, ethereum, base, arbitrum, …
  • address (required) — string — token contract address / mint
  • limit — integer — history rows returned, oldest first (default 365)
  • x402_payment — string — base64 X-PAYMENT payload (omit on the first call to get payment requirements)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• pregrad_signals read-only

  PAID ($0.05/call). Pre-graduation on-chain signals for a Solana mint: bundled-launch detection, curve-aware holder concentration, Token-2022 traps, authority state. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • mint (required) — string — Solana mint address
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• radar_alerts read-only

  PAID ($0.01/call). Recent HostDeFi trend-radar alerts: big dated movers with real market cap, structured JSON. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • limit — integer
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• x402_provider_risk read-only

  PAID ($0.02/call). Vet an x402 seller BEFORE paying it: A–F grade from observable signals (402-spec fidelity, price sanity, payTo presence, TLS, latency), dated crawl snapshot. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • resource (required) — string — resource URL or provider origin
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• buy_api_key

  PAID ($5, one payment). Mint a 30-day HostDeFi Agent-plan API key (5,000 calls, batch enabled) — the key arrives in the paid response; no account, no signup. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only no · destructive no · idempotent no · open-world yes

• swap_evm_quote read-only

  PAID ($0.01/call). Executable EVM swap: a firm KyberSwap-routed quote plus a ready-to-sign transaction for the taker's OWN wallet — non-custodial, no key, no account. A 1% platform fee in the chain's native coin is priced into the returned transaction, on top of the swap. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chainId (required) — string — EVM chain id (e.g. 8453 = Base, 1 = Ethereum, 137 = Polygon, 42161 = Arbitrum, 43114 = Avalanche)
  • sellToken (required) — string — 'native' or the 0x… address of the token being sold
  • buyToken (required) — string — 'native' or the 0x… address of the token being bought
  • sellAmount (required) — string — integer amount in the sell token's base units
  • taker (required) — string — the wallet (0x…) that will sign and broadcast the returned transaction
  • ref — string — optional referrer 0x… address (splits the platform fee)
  • x402_payment — string — base64 X-PAYMENT payload (omit on the first call to get payment requirements)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• swap_evm_price read-only

  PAID ($0.002/call). EVM swap price preview: expected and minimum output for a pair/amount before committing to a firm quote — the cheap look-before-you-swap call. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chainId (required) — string — EVM chain id (e.g. 8453 = Base)
  • sellToken (required) — string — 'native' or the 0x… address of the token being sold
  • buyToken (required) — string — 'native' or the 0x… address of the token being bought
  • sellAmount (required) — string — integer amount in the sell token's base units
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• token_report read-only

  PAID ($0.35/call). HostDeFi full due-diligence report — one document: the A+–F verdict, on-chain signals (authority state, bundled-launch read, holder concentration, Token-2022 traps on Solana), the dated verdict-history series, trend-radar mentions and a rug-ledger cross-check. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chain (required) — string — solana, ethereum, base, arbitrum, …
  • address (required) — string — token contract address / mint
  • x402_payment — string — base64 X-PAYMENT payload (omit on the first call to get payment requirements)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• wallet_exposure read-only

  PAID ($0.10/call). Wallet risk-exposure read for a Solana wallet: its largest holdings graded through the full verdict path, exposure counts by risk tier, and a rug-ledger symbol cross-check. Holdings exposure heuristics — NOT AML attribution or sanctions screening. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • wallet (required) — string — Solana wallet address (base58)
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• token_launches read-only

  PAID ($0.02/call). Fresh token launches with HostDeFi safety pre-reads baked in: newest token profiles annotated with authority state, bundled-launch flag, holder concentration and market depth — the clean flag is fail-closed (true only when every check is provably good). Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • chain — string — chain filter (default solana)
  • limit — integer
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• predict_markets read-only

  PAID ($0.005/call). Polymarket prediction markets HostDeFi tracks (top ~100 by 24h volume): market ids, questions, latest yes/no odds and sampling stats from HostDeFi's own recorded series. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • limit — integer
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• predict_history read-only

  PAID ($0.02/call). 24h odds history for one tracked Polymarket market: [ts, yesUsd, noUsd] points sampled ~1/min into a normalized series — one call, no auth juggling. An untracked market is an uncharged 404. Call once WITHOUT x402_payment to receive the x402 payment requirements (an `accepts` array); pay one of them with any x402 client/wallet, then call again with `x402_payment` set to the base64 X-PAYMENT payload. You are only charged when a result actually comes back.

  Parameters:

  • marketId (required) — string — Polymarket market id (conditionId, from predict_markets)
  • x402_payment — string — base64 X-PAYMENT payload

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.