Tollkit

Find where an IP address is: country, region, city, continent and approximate coordinates, for IPv4 or IPv6. City-level accuracy, not a street address. Data: IP Geolocation by DB-IP (db-ip.com), CC BY 4.0. $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 roughly where an IP address is. Parameters: ip: one IPv4 or IPv6 address. Private and reserved addresses are refused free. Returns: country, region, city, continent and approximate latitude/long…

Read any web page in a real browser and get a summary of it in one call, with its title and final URL. Says when the page was longer than the part summarized. $0.007 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need the gist of one page, not its full text. Use instead: read_page for the full text; read_pages for several pages. Parameters: url: absolute https URL. max_words: summary length, 10-250, default 60. Returns: summary, title, final_url, and a note when the page was longer than the part summarized.

Read a PDF from a URL as text, page by page, with its title, author and page count. Works on text-layer PDFs up to 25 MB and 300 pages; scanned PDFs without a text layer are refused at no charge. $0.005 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: The link is a PDF (a filing, paper, contract or manual) and you need its text. Use instead: read_page for an ordinary web page. Parameters: url: absolute http(s) URL of the PDF. max_pages: read at most this many p…

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:…

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)…

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…

Read any public web page and get its visible text back: the words a person would see, with navigation and boilerplate stripped, plus the title and final URL after redirects. JavaScript pages are rendered in a real browser first. Up to 50,000 characters. Use it to read an article, a doc, a policy or any page you were given a link to. Chain it with a summarizer when the page is long. $0.002 USDC per page over x402. A page that fails to load, returns an error or has no text costs nothing. Call without `payment` to get a quote. The first 3 calls a day through this tool server are free (no wallet…

Read several web pages at once: give up to 5 URLs and get the full visible text of each (up to 20,000 characters a page), rendered in a real browser so JavaScript pages work, with title and final URL. Pages that can't be read are listed with the reason; the rest still come back. Use it after a search to read the results you picked. $0.008 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You picked 2-5 pages to read, for example from web_search results. Use instead: read_page for a single URL; search_and_read when you have a question but …

Capture how any public web page looks: a 1280x800 JPEG from a real browser, returned as base64 with its SHA-256, the title and the final URL. Use it to see a page's layout, check that something renders, or hand the image to a vision model. The image is roughly 50-150 KB of base64 in the response. $0.003 USDC per capture over x402. A page that fails to load or returns an error costs nothing. For signed, timestamped evidence of a page use attest_page instead. 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 n…

Search the web and read the top pages in one step: returns the top web results plus the full visible text of the top 1-3 pages, each rendered in a real browser. Results that can't be read are skipped for the next one down. Optional filters: freshness (past hour to past year), include_domains / exclude_domains (up to 5 sites each), type "news". The fastest way to answer a question from fresh sources. $0.005 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You have a question and want it answered from current sources in one call: it search…

Look up a US public company in SEC EDGAR by ticker or CIK: legal name, exchange, industry, state, fiscal year end, and its latest filings (10-K, 10-Q, 8-K, insider Form 4 and more) with direct links. Filter by form type, e.g. only 10-Ks. $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 who a US public company is, or links to its recent filings. Use instead: sec_financials for the numbers; company_snapshot for profile plus numbers; company_due_di…

Get a US public company's financials as filed with the SEC: revenue, operating income, net income, diluted EPS, total assets, liabilities, equity, cash, operating cash flow and shares outstanding — last 4 fiscal years plus the latest quarter, each tied to its filing. $0.004 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need a US public company's reported numbers. Use instead: company_snapshot to get the profile and filings in the same call; company_due_diligence for computed ratios. Parameters: ticker or cik (one is required). Ret…

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. U…

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…

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 p…

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 …

Free. Run a real extraction against one fixed sample product page and return the result. USE THIS to decide whether the paid tools are worth paying for. It returns the identical shape get_product_details returns, produced by the identical code — not a hand-written example — so what you see is what you get. It takes no arguments and costs nothing. You cannot choose the page: pointing a free endpoint at arbitrary URLs would just be the paid tool with no toll. Use get_product_details for the URL you actually care about. When to use: Before paying, to see exactly what get_product_details return…

Free, forever, no account. Hand back an attestation -- yours or one someone else gave you -- and find out whether the signature holds and whether we issued it. Works on attestations this service did not produce: the answer for those is a clear no, which is the point. Holds no database, so it keeps working whoever is running it. When to use: Someone handed you an attestation, or you want to check one of yours. Parameters: attestation: the full attest_page response or just its attestation object, as JSON text. Returns: whether the signature is valid and whether this service issued it, with the …

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: addres…

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:…

Get the weather forecast for any latitude/longitude in the world, or a US street address: the next 7 days in day and night periods (temperature, rain, wind, summary). US locations use the National Weather Service and include any active watches, warnings or advisories; elsewhere the forecast is from MET Norway (in °C and km/h). $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 the forecast for a place. Use instead: airport_delays for flight delays…

Search the web and get Google's top results as clean JSON: title, URL, snippet and date for each, plus the direct answer when Google shows one. Optional filters: freshness (past hour, day, week, month or year), include_domains or exclude_domains (up to 5 sites each), and type "news" for news articles with publisher and date. Up to 10 results. To get the pages' full text in the same call, use search_and_read. $0.003 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You need sources or facts and don't have URLs yet; the snippets often answe…

Get the whole x402 market as one dataset: every active seller with rank, 30-day calls, estimated revenue, paying wallets, categories and unusual-number labels, plus category totals. Rebuilt weekly from Coinbase's Bazaar catalog. $0.10 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You are analysing the whole x402 market and want every seller in one file. Use instead: x402_seller_lookup or best_x402_tools for a single seller or task (cheaper). Returns: every active seller with rank, 30-day calls, revenue estimate, paying wallets, catego…

Look up any x402 seller by hostname: its rank among all sellers, 30-day calls, estimated revenue and paying wallets, each endpoint's numbers and price, its categories and competitors, and labels where its numbers look unusual. Weekly, from Coinbase's Bazaar catalog. $0.02 USDC per call over x402. Failed calls cost nothing. Call without `payment` to get a quote. When to use: You want one x402 seller's numbers: rank, calls, revenue, buyers, endpoints and competitors. Parameters: host: the seller's hostname, e.g. stableenrich.dev. Returns: rank, 30-day calls, estimated revenue, paying wallets, …