Tollkit Crypto

io.github.UltraStarzPublished by GitHub account UltraStarzv0.1.0Updated Nov 4, 2026

Crypto news, perps, market pulse, price history and token checks for AI agents. USDC per call.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

Remote MCP server for crypto data: token checks, prices, wallet balances, transaction lookups, perps, news and market pulse, paid per call in USDC.

What you can do
  • Check wallets and tokens: balances, portfolio valuation, token info, price, safety warnings and pre-trade checks on Base, Ethereum and Solana
  • Look up transactions and past USD prices from Chainlink feeds
  • Read Hyperliquid perpetuals data and a one-call market pulse with fear and greed, funding and movers
  • Fetch recent crypto news for a coin or topic with a short AI read of the coverage
  • Quote prices first and pay per call with a signed x402 payment
When to use it
Useful when an assistant needs live on-chain facts about tokens, wallets or transactions, or a quick read of crypto markets and news, without holding an API key. Suited to agents that already have an x402-capable wallet and want metered, pay-per-call access.
Requirements
Remote Streamable HTTP endpoint; no account or API key. Paid tools are billed in USDC per call over x402 on Base or Solana, so an x402 wallet able to sign payment quotes is needed. A call made without the payment argument returns a price quote instead of data.
Before you install
Paid tools spend real USDC per call, with prices from about $0.001 to $0.10 depending on the tool; failed calls are stated as not charged. The server states it never holds funds or keys, but the assistant's wallet signs payments, so spending limits matter. Some tools send token or topic queries to third-party news and web sources.

Installation

In SourceWeft

  1. Open Tollkit Crypto in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.UltraStarz%2Ftollkit-crypto/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tollkit-crypto": {
      "type": "http",
      "url": "https://api.tollkit.dev/mcp/crypto"
    }
  }
}

README

Tollkit MCP server

Pay-per-call tools for AI agents, as one remote MCP server:

https://api.tollkit.dev/mcp

No account and no API key. Each paid tool costs a fixed amount of USDC, paid per call with x402 on Base or Solana. A call that fails is never charged.

Listed in the official MCP Registry as io.github.UltraStarz/x402-extract.

Connect

Add the URL above as a remote (Streamable HTTP) MCP server in Claude, Cursor or any MCP client. In clients that take a JSON config:

json
{  "mcpServers": {    "tollkit": { "url": "https://api.tollkit.dev/mcp" }  }}

Paying: MCP has no 402 status, so a paid tool called without its payment argument returns the price quote as its result. Sign that quote with your x402 wallet and call the tool again with payment set. Six tools are always free: try_it_free (a real sample result), get_service_info, find_service, check_service, check_my_balance and verify_attestation. Fourteen give 3 free calls a day without a payment: read_page, screenshot_page, pdf_to_text, weather_forecast, airport_delays, geocode_address, exchange_rate, ip_lookup, wallet_balance, token_info, transaction_lookup, token_price, token_check and sec_company.

Tools

GroupToolsPrice per call
Web pages & documentsweb search (with date, site and news filters), search + read top pages, read a page or up to 5 at once in a real browser, screenshot, summarize, page brief, PDF to text$0.002 – $0.008
Public dataSEC filings, financials, company snapshot and due diligence; weather anywhere in the world (by point, or US address); FAA airport delays; US address geocoding; exchange rates; IP lookup$0.002 – $0.03
On-chain (Base, Ethereum, Solana)wallet balance and portfolio, token info, token price, token safety check, transaction lookup, pre-trade check$0.001 – $0.01
x402 market databest x402 tools for a task, seller lookup, full market dataset$0.01 – $0.10
Product dataprice, stock, brand, SKU and images from a store page; compare up to 5$0.01 – $0.04
Proofsigned, timestamped record of what a page said$0.05

Live prices: /health · every tool with its URL and body: llms.txt · tollkit.dev/tools

Without MCP

Every tool is also a plain HTTP endpoint: POST the JSON body, get HTTP 402 with the price, pay with any x402 client (for example @x402/fetch), repeat the request. OpenAPI per hostname, e.g. https://data.tollkit.dev/openapi.json.

This repo

server.json is the MCP Registry entry. src/ holds an older stdio client (the x402-extract-mcp npm package) that only wraps product extraction and is no longer maintained; use the remote server above instead.

More

MIT licensed.

Source: README.md at commit c0603be

Tools

12

check_my_balance

Check my wallet balance

Free. Check how much USDC is left in your own wallet on Base, so you can tell your human before you run out. Returns the balance and whether it's below your threshold. Read-only: it moves nothing. Tollkit never holds anyone's funds or keys. When to use: You pay for tools from a wallet and want to know if it's running low. Use instead: wallet_balance for any wallet, chain or token. Parameters: address: the wallet you pay from. network: base (default) or sepolia. low_below: your low-balance threshold in USDC, default 1. Returns: the USDC balance and whether it's below low_below. Free.

Parametersaddressrequirednetworklow_below

wallet_balance

Wallet balance

Check a wallet's balances on Base, Ethereum or Solana: native ETH or SOL, USDC (plus USDT on Ethereum and Solana), and any token contracts or SPL mints you list (up to 20), with symbols and decimals applied. Read live from the chain. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet needed). When to use: You need what a wallet holds, in token amounts. Use instead: wallet_portfolio for USD values and a total; check_my_balance (free) for your own USDC on Base. Parameters: address is required. chain: base (default), ethereum or solana; the address format must match. tokens: up to 20 extra ERC-20 contracts or SPL mints to include. Returns: native coin, USDC (USDT on Ethereum and Solana) and the tokens you listed, each with symbol, decimals and amount.

Parameterschaintokensaddressrequiredpayment

token_info

Token info

Look up a token on Base, Ethereum (ERC-20 contract) or Solana (SPL mint): name, symbol, decimals and total supply, plus mint and freeze authority on Solana, read live from the chain. Use it to confirm what an address actually is before acting on it. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet needed). When to use: You have a token address and need to know what it is before acting on it. Use instead: token_check for safety warnings and liquidity; token_price for its price. Parameters: token: ERC-20 contract or SPL mint. chain: base (default), ethereum or solana. Returns: name, symbol, decimals, total supply; on Solana, mint and freeze authority.

Parameterschaintokenrequiredpayment

transaction_lookup

Transaction lookup

Look up a transaction on Base, Ethereum or Solana: did it succeed, when, who sent it, the fee, and every token movement with symbols and amounts (ERC-20 transfers; on Solana, SOL and token balance changes per owner). Use it to confirm a payment actually landed. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet needed). When to use: You have a transaction hash and need to know if it went through and what moved. Parameters: hash: 0x hash on Base or Ethereum, base58 signature on Solana. chain: base (default), ethereum or solana; it must match the hash. Returns: status, time, sender, fee, and every token transfer with symbol and amount (on Solana, balance changes per owner).

Parametershashrequiredchainpayment

token_price

Token price

Get a token's current USD price on Base, Ethereum or Solana, read from its deepest on-chain pool (Uniswap v3 against USDC or WETH; on Solana, Orca Whirlpools against USDC or SOL) rather than a price API. Returns the pool used, how much liquidity backs the price, and a flag when the pool is too thin to trust. $0.001 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet needed). When to use: You need a token's current USD price straight from the chain. Use instead: price_history for past prices; token_check for price plus safety warnings; crypto_market_pulse for BTC, ETH and SOL at once. Parameters: token: ERC-20 contract or SPL mint ("SOL" works on Solana). chain: base (default), ethereum or solana. Returns: price_usd, the pool used, its liquidity, and a thin_liquidity flag when the price shouldn't be trusted.

Parameterschaintokenrequiredpayment

token_check

Token check

Check a token before buying, sending or accepting it, on Base, Ethereum or Solana: what it is, its USD price and liquidity, and plain warnings read from the chain (no pool, thin liquidity; on Base and Ethereum the contract's owner and whether it is upgradeable or can mint, pause, blacklist or set fees; on Solana an active mint or freeze authority). $0.004 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet needed). When to use: Before buying, accepting or sending an unfamiliar token. Use instead: pretrade_check when you're about to trade a specific amount (adds price impact, your holding and news); token_info for the basics only. Parameters: token: ERC-20 contract or SPL mint. chain: base (default), ethereum or solana. Returns: what the token is, price and liquidity, and plain-language warnings (owner, upgradeable, can mint, pause, blacklist or set fees; Solana mint or freeze authority).

Parameterschaintokenrequiredpayment

wallet_portfolio

Wallet portfolio value

Value a wallet in USD on Base, Ethereum or Solana: each holding (native coin, USDC/USDT and any tokens you list) priced from on-chain pools, the total, and warnings for thin pools or positions bigger than their pool. $0.005 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need a wallet's value in USD: each holding priced and the total. Use instead: wallet_balance when amounts are enough (cheaper). Parameters: address is required. chain: base (default), ethereum or solana. tokens: up to 20 extra contracts or mints to include. Returns: holdings[] with amount, USD price, USD value and pool used, the total in USD, and warnings for thin pools or positions bigger than their pool.

Parameterschaintokensaddressrequiredpayment

pretrade_check

Pre-trade token check

Before trading a token on Base, Ethereum or Solana: its USD price and liquidity, plain warnings read from the chain, how big your planned trade is next to the pool (rough price impact), how much your wallet already holds, and recent web results about the token. Facts, not advice. $0.01 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: Right before a trade, to see if the size is sane for the pool and what's being said about the token. Use instead: token_check when you aren't trading yet. Parameters: token is required. chain: base (default), ethereum or solana. amount_usd: your planned size, for price impact against pool depth. wallet: your address, to show what you already hold. Returns: price, liquidity, chain warnings, rough price impact for amount_usd, your current holding, and recent web results. Facts, not advice.

Parameterschaintokenrequiredwalletpaymentamount_usd

crypto_news

Crypto news

Get recent crypto news for a coin or topic: up to 10 articles from the past hour, day or week with publisher, date, snippet and link, plus a short AI read of the coverage (mood: positive, negative, mixed or neutral; a summary; main themes) written only from those headlines. A read of the news, not advice. $0.004 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want what's being said about a coin or the market right now. Use instead: web_search with type "news" for non-crypto topics; crypto_market_pulse for numbers instead of headlines. Parameters: query: a coin or topic; leave it out for the whole market. freshness: hour, day (default) or week. num: 1-10 articles, default 8. Returns: articles[] with title, publisher, date, snippet and link, plus mood (positive, negative, mixed or neutral), a summary and themes, written only from those headlines.

Parametersnumquerypaymentfreshness

perps_market

Perps market (Hyperliquid)

Hyperliquid perpetuals: mark and oracle price, 24h change, current hourly funding rate (positive means longs pay shorts) and annualized, open interest in coins and USD, 24h volume and max leverage. Name up to 20 coins, or leave coins out to get the top markets sorted by volume, open interest, funding or 24h move. funding_hours adds hourly funding history for one coin. $0.001 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need perpetual futures data from Hyperliquid: funding, open interest, leverage, or the top markets. Use instead: crypto_market_pulse for a one-call market overview; token_price for an on-chain spot price. Parameters: coins: up to 20 Hyperliquid names (e.g. BTC, ETH, kPEPE); leave out for the top markets. sort and limit (default volume, 10) apply only when coins is left out. funding_hours (1-168) adds hourly funding history and needs exactly one coin. Returns: markets[] with mark, oracle and mid price, 24h change, hourly and annualized funding (positive: longs pay shorts), open interest in coins and USD, 24h volume and max leverage; not_found for unknown names.

Parameterssortcoinslimitpaymentfunding_hours

crypto_market_pulse

Crypto market pulse

Get the crypto market at a glance in one call: the Crypto Fear & Greed Index (today, yesterday, a week ago), BTC, ETH and SOL with perp price, 24h change, funding and Chainlink reference price, the highest and lowest funding rates, the biggest 24h gainers and losers, and Hyperliquid's total open interest and volume. $0.003 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want the state of the crypto market in one call, for example before deciding anything else. Use instead: perps_market for specific coins or more markets; crypto_news for the headlines behind a move. Returns: Fear & Greed (today, yesterday, a week ago), BTC, ETH and SOL with perp price, 24h change, funding and Chainlink price, funding extremes, top gainers and losers, and Hyperliquid totals. Takes no parameters.

Parameterspayment

price_history

Crypto price history

Get past USD prices for a crypto asset (ETH, BTC, SOL, LINK and others with a Chainlink feed) over up to 365 days: up to 100 points read from Chainlink's on-chain price feed on Ethereum, each with its time and round, plus first, last, high, low and percent change. $0.002 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need past prices for a major asset: a trend, a high or low, or the change over a period. Use instead: token_price for the current price of any token, including ones without a Chainlink feed. Parameters: asset: a symbol with a Chainlink USD feed (ETH, BTC, SOL, LINK and others). days: 1-365, default 7. points: 2-100 evenly spaced prices, default 24. Returns: points[] each with time, price_usd and Chainlink round, plus first, last, high, low and percent change.

Parametersdaysassetrequiredpointspayment

Version history

1
  1. v0.1.0LatestOct 21, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.