1gateway

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

Pay-per-call tools for agents via x402 (USDC on Base): Korean data, doc-to-Markdown, web utilities.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "1gateway": {
      "url": "https://1gateway.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (42)

• kr_apartment_trades

  Use when you need actual apartment sale prices in a South Korean district for a month (property research, valuation, comps). Data: MOLIT (Korea land ministry) reported deals since 2006, updated daily. Input: region (5-digit LAWD_CD, e.g. 11680 Gangnam-gu), month (YYYYMM). Output: JSON trades with contract date, complex (Korean + romanized), area m2, floor, build year, price in KRW and USD, price per m2, deal type, cancelled flag. Example: ?region=11680&month=202609 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • region (required) — string — 5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu, 11110 = Jongno-gu, 41135 = Seongnam Bundang-gu. Unknown codes → 400 (not charged).
  • month (required) — string — Contract month YYYYMM, 200601 to the current month (KST)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_apartment_trades_summary

  Use when you need a quick housing-market snapshot for a South Korean district-month instead of raw trades. Data: MOLIT reported apartment sales, cancelled deals excluded. Input: region (5-digit LAWD_CD, e.g. 11680), month (YYYYMM). Output: JSON count, median/average/min/max price and price per m2 and per pyeong in KRW and USD, breakdown by size class, top complexes by volume. Example: ?region=11680&month=202609 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • region (required) — string — 5-digit 시군구 code (LAWD_CD), e.g. 11680 = Seoul Gangnam-gu. Unknown codes → 400 (not charged).
  • month (required) — string — Contract month YYYYMM, 200601 to the current month (KST)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_bok_ecos_series

  Use when you need official Bank of Korea statistics (base rate, money supply, key indicators) as a time series. Input: stat (ECOS table code, e.g. 722Y001), cycle (A/S/Q/M/SM/D), start, end (period format of cycle), optional item (e.g. 0101000). Output: JSON series with English labels, units, observations [{period,value}] (max 1,000 rows) and source attribution. Only BOK-authored tables are served. Example: ?stat=722Y001&cycle=M&start=202401&end=202412&item=0101000 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • stat (required) — string — ECOS statistic table code, e.g. 722Y001 (base rate). Non-BOK tables → 403 (not charged).
  • cycle (required) — string — A annual, S semi-annual, Q quarterly, M monthly, SM semi-monthly, D daily
  • start (required) — string — Start period in ECOS format (A: YYYY, Q: YYYYQn, M: YYYYMM, D: YYYYMMDD)
  • end (required) — string — End period, same format as start
  • item — string — Item code 1 (e.g. 0101000). Optional item2..item4 also accepted.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_weather_forecast

  Use when you need the official weather forecast for a point in South Korea for the next ~3-5 days. Data: KMA (Korea Meteorological Administration) village forecast on a 5 km grid, issued 8 times a day. Input: lat, lon (WGS84 decimal; Korea only). Output: JSON hourly then 3-hourly temperature C, sky, precipitation type and probability %, rain and snow amounts, humidity %, wind; plus daily min/max. Example: ?lat=37.5665&lon=126.978 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • lat (required) — ['number', 'string'] — Latitude, WGS84 decimal degrees (KMA domain ≈ 32–44; outside → 400, not charged)
  • lon (required) — ['number', 'string'] — Longitude, WGS84 decimal degrees (KMA domain ≈ 123–133)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_public_holidays

  Use when you need South Korea's official public holidays for a year (business-day calculation, scheduling, settlement and payroll calendars). Data: KASI (Korea Astronomy and Space Science Institute) special-day register, incl. substitute and temporary holidays once promulgated. Input: year (YYYY, 2004-2100). Output: JSON list with date, weekday, Korean and English name, isPublicHoliday, kind. Example: ?year=2026 Price: $0.0027 USDC (Base or Solana) via x402.

  Parameters:

  • year (required) — ['number', 'string'] — Year YYYY (2004–2100)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_trade_exports_10day

  Use when you need South Korea's earliest export read: the Korea Customs 10-day provisional release (days 1-10, 1-20, full month; out on the 11th, 21st and 1st). Input: optional month (YYYYMM) and period (10, 20, full); default latest. Output: JSON exports in USD with YoY %, latest 10-day increment, 10 key items (semiconductors, cars, ships...) and 10 markets (China, US, EU, Vietnam...) with YoY and share, next release date. Example: ?month=202609 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • month — string — Release month YYYYMM (default: latest release; data from 2024-09)
  • period — string — 10 (days 1-10), 20 (days 1-20) or full; requires month. Default: latest available for the month

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_trade_hs

  Use when you need South Korea's monthly trade for a product by HS code (e.g. 8542 chips, 870323 cars, 2710 petroleum). Data: Korea Customs Service, finalized monthly. Input: hs (2-10 digit prefix), optional month (YYYYMM, default latest), limit (1-100), sort (exports, imports, balance, total). Output: JSON totals (exports FOB, imports CIF, balance in USD, kg) with YoY % and 10-digit HSK lines with English HS descriptions and YoY. Example: ?hs=8542&month=202608 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • hs (required) — string — HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)
  • sort — string — Line order (default exports)
  • limit — ['number', 'string'] — Max 10-digit lines returned (1-100, default 20)
  • month — string — Month YYYYMM (default: latest finalized month)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_trade_pulse

  Use when you need a one-call read on South Korea's export cycle for macro, FX or chip-sector analysis. Data: Korea Customs 10-day and monthly releases. Input: none. Output: JSON headline (latest exports and YoY, semiconductor share, strongest/weakest item and market, 3-month average YoY, momentum), latest release by item and market, 12 monthly export totals with YoY, and HS 8542 integrated-circuit trade for the latest month. Example: /v1/trade/pulse Price: $0.0045 USDC (Base or Solana) via x402.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_company_resolve

  Use when an agent must identify a South Korean company before looking up its profile or public-procurement record. Input: one of business_number (10 digits), dart_corp_code, stock_code (KRX, e.g. 005930) or q (company name, exact match ignoring 주식회사/(주)/spacing); first wins. Output: JSON companies with stable companyId, Korean and English names, stock code, DART code, match type, ambiguous flag. Data: OpenDART, KONEPS. Example: ?stock_code=005930 Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • q — string — Company name (Korean or English), matched exactly after removing legal-form words
  • stock_code — string — KRX stock code
  • dart_corp_code — string — OpenDART corp_code (8 digits)
  • business_number — string — Business registration number (사업자등록번호), 10 digits

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_company_profile

  Use when an agent needs a normalized profile of a South Korean company for KYB, research or sales. Input: id (companyId from /v1/kr/company/resolve). Output: JSON profile: names, business/corporate/DART/stock ids, market, KSIC code, founding date, fiscal year end, address, homepage, KONEPS supplier registration. No CEO names. DART data is a weekly snapshot of KRX-listed companies (asOf in response). Data: OpenDART, KONEPS. Example: ?id=kr-dart-00126380 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • id (required) — string — companyId from /v1/kr/company/resolve

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_company_procurement

  Use when an agent needs a South Korean company's government contract wins for sales, credit or competitor research. Input: id (companyId) or business_number; optional from/to (YYYY-MM-DD, max 366 days, default last 12 months), category (goods,works,services,foreign), min_amount, limit, offset. Output: JSON summary (award count, total and largest KRW, top agencies) and awards with title, agency, amount, date. Data: KONEPS. Example: ?id=kr-dart-00126380 Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • id — string — companyId from /v1/kr/company/resolve; give id or business_number
  • to — string — Bid opening date to (default: today)
  • from — string — Bid opening date from (default: 365 days before to)
  • limit — ['number', 'string'] — Awards per page (default 50)
  • offset — ['number', 'string'] — Paging offset (from page.nextOffset)
  • category — string — Comma list of goods, works, services, foreign (default all)
  • min_amount — ['number', 'string'] — Only awards of at least this many KRW
  • business_number — string — Business registration number; give id or business_number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kr_business_status

  Use when an agent must check that a South Korean business is still operating before paying, contracting or onboarding it (KYB, invoice checks). Input: b_no (1-20 business registration numbers, comma-separated, hyphens ok). Output: JSON per number: status (active, suspended, closed, unregistered), VAT taxpayer type, closure date, tax-type change and e-invoice dates, companyId. Data: National Tax Service, synced every 30 min. Example: ?b_no=1248100998 Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • b_no (required) — string — Business registration numbers (사업자등록번호), 10 digits each, comma-separated (max 20); invalid check digit → 400, not charged

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• web_metadata

  Use when an agent needs to know what a URL is before reading it, or to build a link preview or citation. Input: url (public http/https). Output: JSON with final URL after redirects, HTTP status, content type, title, description, site name, language, canonical, preview image, favicon, Open Graph and Twitter tags, RSS/Atom feeds, hreflang alternates, JSON-LD types, robots, first H1. No JavaScript is run. Example: ?url=https://developer.mozilla.org/en-US/ Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • url (required) — string — Public http(s) URL; private/internal addresses → 400 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• domain_lookup

  Use when an agent must check a domain: does it resolve, who hosts its DNS and mail, is email authenticated, how old is it, when does it expire. Input: domain (e.g. example.com; URLs accepted). Output: JSON DNS records (A, AAAA, CNAME, MX, NS, TXT, CAA, SOA), mail provider, parsed SPF and DMARC, DNS provider, and RDAP registration (registrar, created, expires, age in days, status, DNSSEC). No contact data. Example: ?domain=google.com Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • domain (required) — string — Public domain or hostname (punycode for IDNs, e.g. xn--...); a URL is reduced to its hostname. Internal/reserved names → 400 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• fx_rates

  Use when you need an official daily FX rate or currency conversion (USD, EUR, KRW, JPY, CNY, GBP + 24 more). Input: base (default EUR), optional symbols (comma list), date (YYYY-MM-DD, last ~90 days; weekends use the prior fixing), amount. Output: JSON rates for the fixing date, % change vs prior fixing, converted amounts, raw ECB EUR rates. Source: ECB statistics, updated each TARGET day ~16:00 CET; reference only. Example: ?base=USD&symbols=KRW,JPY&amount=100 Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • base — string — Base currency, ISO 4217 (one of the 30 ECB reference currencies; default EUR)
  • date — string — Fixing date YYYY-MM-DD within the last ~90 days (default latest)
  • amount — ['number', 'string'] — Amount in base currency to convert
  • symbols — string — Comma-separated target currencies (default: all). Supported: EUR,USD,JPY,KRW,CNY,GBP,AUD,BRL,CAD,CHF,CZK,DKK,HKD,HUF,IDR,ILS,INR,ISK,MXN,MYR,NOK,NZD,PHP,PLN,RON,SEK,SGD,THB,TRY,ZAR

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• time_convert

  Use when scheduling across time zones or turning a local time into UTC without guessing DST. Input: to (IANA zones or KST, PST, CET...), optional from (zone of a local time, default UTC), time (ISO 8601, Unix seconds, or now). Output: JSON UTC instant, Unix time, and per zone: local ISO time with offset, weekday, abbreviation, DST and business-hours flags, day difference. Example: ?time=2026-10-12T09:00&from=Asia/Seoul&to=America/New_York,Europe/London Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • to (required) — string — 1–25 target zones, comma-separated (IANA names like Asia/Seoul, UTC, or abbreviations like KST, PST, CET)
  • from — string — Zone of the input local time (default UTC; ignored when time has an offset)
  • time — string — ISO 8601 date-time (2026-10-12T09:00, 2026-10-12T09:00:00+09:00), Unix seconds/ms, or now

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• site_profile

  Use when an agent must vet or research a website in one call (lead research, security or SEO check, is this site legit). Input: url or bare domain. Output: JSON page metadata, HTTP status, HTTPS and HTTP-to-HTTPS redirect, server and hosting hints, 7 security headers, robots.txt (sitemaps, AI-crawler rules), llms.txt presence, plus domain DNS, mail provider, SPF/DMARC and RDAP registrar, age and expiry. Example: ?url=stripe.com Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • url (required) — string — Site URL or bare domain (https:// assumed); private/internal targets → 400 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_gas

  Use when an agent must price or time a Base transaction. Input: none. Output: JSON current and next base fee, priority fee tiers (slow/standard/fast from the last 20 blocks), suggested maxFeePerGas, block fullness, and typical cost of an ETH transfer, ERC-20 transfer/approve, DEX swap, NFT mint and contract deploy (L2 fee + L1 data fee) in ETH and USD. Example: /v1/onchain/base/gas Price: $0.002 USDC (Base or Solana) via x402.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• weather_global

  Use when an agent needs the weather anywhere in the world. Input: lat, lon, optional hours (0-72 hourly steps, default 24), tz (IANA zone for daily summaries, default UTC). Output: JSON current temperature, symbol, wind, humidity, cloud, pressure; hourly series; daily min/max, precipitation, max wind, symbol for ~10 days. Data: MET Norway. Example: ?lat=51.5072&lon=-0.1276&tz=Europe/London Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • lat (required) — ['number', 'string'] — Latitude, WGS84 decimal degrees (rounded to 0.01)
  • lon (required) — ['number', 'string'] — Longitude, WGS84 decimal degrees (rounded to 0.01)
  • tz — string — IANA time zone for daily summaries and local hours (default UTC)
  • hours — ['number', 'string'] — Hourly steps to return (default 24)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• package_vulnerabilities

  Use when an agent must check a dependency before installing or upgrading: is this exact package version vulnerable? Input: package, ecosystem (npm, PyPI, Go, Maven, crates.io, NuGet, RubyGems, Packagist...), version. Output: JSON vulnerable yes/no, counts by severity, advisories (GHSA/CVE id, summary, severity, CVSS, CWE, fixed versions, links). Data: OSV.dev. Example: ?package=lodash&ecosystem=npm&version=4.17.15 Price: $0.003 USDC (Base or Solana) via x402.

  Parameters:

  • package (required) — string — Package name as in its registry (Go: module path; Maven: group:artifact)
  • ecosystem (required) — string — Package ecosystem (case-insensitive; pip/python, cargo/rust, composer, gem also accepted)
  • version (required) — string — Exact released version

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sanctions_screen

  Use when an agent must check a person, company, vessel or aircraft against the U.S. Treasury OFAC SDN list before paying, onboarding or shipping. Input: name (fuzzy, aliases included), optional type, min_score, limit. Output: JSON potential matches with score, SDN entry, programs, countries, aliases, OFAC link, list as-of date, data age. Not a legal determination. Example: ?name=Lazarus+Group Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • name (required) — string — Person, company, vessel or aircraft name in Latin script; fuzzy match over SDN names and aliases
  • type — string — Only match this SDN entry type
  • limit — ['number', 'string'] — Max matches (default 10)
  • lists — string — Lists to search: ofac (default), eu, uk, comma-separated, or all
  • min_score — ['number', 'string'] — Name match threshold 0.6-1 (default 0.85)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kyb_check

  Use when an agent must vet a company or counterparty before paying, onboarding or invoicing. Input: name, optional country (ISO2), lei, vat (EU, with prefix). Output: JSON summary (sanctions hits, LEI found/status, VAT valid), sanctions matches across OFAC SDN, EU and UK lists, GLEIF entity record with parents, VIES VAT result; a down VIES/GLEIF marks only that part. Not a legal determination. Example: ?name=Siemens+AG&lei=W38RGI023J3WT1HWRP32&vat=DE129273398 Price: $0.02 USDC (Base or Solana) via x402.

  Parameters:

  • name (required) — string — Company or person name in Latin script
  • lei — string — Legal Entity Identifier, if known (exact LEI lookup instead of name search)
  • vat — string — EU VAT number with country prefix (Greece = EL), validated in VIES
  • country — string — ISO 3166-1 alpha-2 country of the legal address (narrows the LEI search)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sanctions_address

  Use when an agent must check a crypto wallet against the digital currency addresses on the U.S. Treasury OFAC SDN list before paying or accepting funds. Input: address (EVM matched on every EVM chain; BTC, TRX, SOL...), optional chain. Output: JSON listed yes/no, SDN entry, programs, listed currency and network, OFAC link, list as-of date, data age. Not a legal determination. Example: ?address=0x098B716B8Aaf21512996dC57EB0615e2383E2f96 Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — Crypto address to check (0x… EVM, BTC, TRX, SOL, …)
  • chain — string — Optional chain (ethereum, base, bitcoin, tron, solana, …): checks the address format and marks listings on that network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sec_filings

  Use when an agent needs a U.S. public company's SEC filings: latest 10-K/10-Q, 8-K events, proxies, S-1s. Input: ticker or cik, optional form (comma list, e.g. 10-K,8-K), since (YYYY-MM-DD), limit. Output: JSON company profile (CIK, name, industry, exchange, fiscal year end) and filings with dates, 8-K item codes and titles, XBRL flags, sec.gov links. Insider forms without filer names. Data: SEC EDGAR. Example: ?ticker=AAPL&form=10-K,8-K Price: $0.0027 USDC (Base or Solana) via x402.

  Parameters:

  • cik — string — SEC Central Index Key (e.g. 320193); give ticker or cik
  • form — string — Only these form types, comma-separated (10-K, 10-Q, 8-K, DEF 14A, S-1, 4, 13F-HR…)
  • limit — ['number', 'string'] — Max filings (default 20)
  • since — string — Only filings on or after this date (YYYY-MM-DD)
  • ticker — string — U.S. ticker (AAPL, BRK.B); give ticker or cik

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• us_company_intelligence

  Use when an agent researches a U.S. public company (due diligence, investing, competitors) and wants one sourced brief instead of many calls. Input: ticker or cik, optional news=false. Output: JSON profile, 3 fiscal years + latest quarter + balance sheet from SEC XBRL, YoY growth, rule-based risk signals (8-K items, late filings, losses) with evidence, recent 8-K events, latest news (title, link, date, publisher summary), sources. Example: ?ticker=NVDA Price: $0.035 USDC (Base or Solana) via x402.

  Parameters:

  • cik — string — SEC Central Index Key; give ticker or cik
  • news — string — Include recent news (default true)
  • ticker — string — U.S. ticker (NVDA, BRK.B); give ticker or cik

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• satellite_image

  Use when an agent must see a place from above or check vegetation, water or change. Input: lat, lon, radius_m (200-10000), mode (true_color, false_color, ndvi, ndwi, moisture), date, days back, max_cloud. Picks the clearest Sentinel-2 scene by cloud share inside your area, not the whole tile. Output: JSON PNG URL (+ other modes), scene date, area cloud %, alternatives. No scene: 404, not charged. Example: ?lat=37.5665&lon=126.978 Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • lat (required) — ['number', 'string'] — Latitude, WGS84 decimal degrees
  • lon (required) — ['number', 'string'] — Longitude, WGS84 decimal degrees
  • date — string — Latest acceptable scene date YYYY-MM-DD (default today; 2017-01-01 or later)
  • days — ['number', 'string'] — Look-back window in days before date (default 30)
  • mode — string — Rendering (default true_color); URLs for the other modes are returned too
  • size — ['number', 'string'] — Image width/height in px (default 1024)
  • radius_m — ['number', 'string'] — Half-width of the square area in meters (default 2000)
  • max_cloud — ['number', 'string'] — Target max cloud % inside the area (default 40); if no scene meets it the clearest is returned with fulfillment=best_available

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_token_risk

  Base ERC-20 token risk scan: honeypot check, rug pull check, token safety / scam check. Use when vetting a token. Input: address. Output: JSON risk signals w/ block+evidence: honeypot test (buy/sell simulation, taxes), rug-pull signals (owner, mint/pause/blacklist/fee fns, proxy+admin, owner-held supply, Uniswap/Aerodrome pool depth), notChecked. Signals, not a safe verdict. Bad input/EOA: 400, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — Token contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOAs, bad checksums → 400 before payment (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_wallet_balances

  Use when an agent needs what a Base address holds in one call instead of one RPC call per token. Input: address; optional tokens (up to 20 ERC-20 addresses, comma-separated; default USDC, EURC, USDbC, WETH, cbBTC, cbETH, wstETH). Output: JSON block+time, ETH balance, per-token symbol, decimals, raw and decimal balance, nonce, isContract. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1 Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — Wallet or contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). Bad input → 400 (not charged)
  • tokens — string — Up to 20 comma-separated ERC-20 contract addresses on Base. Omit for the default set. A contract that is not an ERC-20 is listed with status not_an_erc20.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_token_info

  Use when an agent needs an ERC-20's basics on Base before quoting, transferring or approving it. Input: address (token contract); optional holder (adds balance and share of supply) and spender (adds allowance, flags unlimited approvals). Output: JSON block+time, name, symbol, decimals, totalSupply raw and decimal, known issuer if curated. Name/symbol are self-reported. EOA or non-ERC-20: 4xx, not charged. Example: ?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — ERC-20 token contract on Base mainnet (0x + 40 hex; mixed case must be a valid EIP-55 checksum). EOA → 400, non-ERC-20 contract → 422 (not charged)
  • holder — string — Optional address whose token balance and share of total supply to include
  • spender — string — Optional spender; with holder, adds allowance(holder, spender). Needs holder.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_tx

  Use when an agent must confirm a Base transaction or payment landed: did it succeed, who paid whom, how much of which token. Input: hash. Output: JSON status (success/reverted), block+time, confirmations, from, to, ETH value, fee (L2 gas + L1 data fee), decoded ERC-20 transfers with symbol and decimal amount (first 25). Unknown or unmined hash: 404, not charged. Example: ?hash=0x284f8abed91b5631ee28bdb1ccfe78374e18c480cb2ab25f28e3bfac5210fe0b Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • hash (required) — string — Transaction hash on Base mainnet (0x + 64 hex). Unknown or not yet mined → 404 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• base_token_flows

  Use when an agent must see who is accumulating or dumping a Base ERC-20 right now. Input: token address, minutes (1-60, default 60), limit (1-25). Output: JSON top net buyers and sellers (net, received, sent, contract or EOA), largest transfers with tx hash, volume, mints/burns, active wallets, covered window. Busy tokens get a shorter window. Example: ?address=0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed Price: $0.004 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — ERC-20 token contract on Base mainnet. EOA → 400, non-ERC-20 → 422 (not charged)
  • limit — ['number', 'string'] — Rows per list (default 10)
  • minutes — ['number', 'string'] — Look-back window in minutes (default 60). Very busy tokens are cut short; see window.complete

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sol_token_info

  Use when an agent needs a Solana token's basics before quoting, transferring or accepting it. Input: mint. Output: JSON slot, program (spl-token or token-2022), decimals, supply raw and decimal, mint and freeze authority, Token-2022 extensions (transfer fee, permanent delegate, transfer hook, default frozen, metadata), known issuer if curated. Not a mint: 422, unknown: 404, not charged. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • mint (required) — string — Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sol_token_risk

  Use when an agent is about to buy, accept or list a Solana token. Input: mint. Output: JSON riskLevel and rule-based signals with evidence (mint or freeze authority not renounced, permanent delegate, transfer hook, transfer fee, default-frozen accounts, mutable metadata), top-10 holder concentration with owners. Curated issuer stablecoins are marked as expected controls. Not an audit. Example: ?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • mint (required) — string — Token mint address on Solana mainnet (base58, 32 bytes). Bad input → 400, not a mint → 422 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sol_wallet_balances

  Use when an agent needs what a Solana address holds in one call. Input: address. Output: JSON slot, SOL balance, every non-zero token (mint, token account, program, decimals, raw and decimal balance, frozen flag; first 50), counts of token and empty accounts. Chain state only, no prices. Bad input: 400, not charged. Example: ?address=CV8t6fnSsckB3bzJSVRxQjVvTgdB35q11Fu3eaF1nz8u Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • address (required) — string — Wallet address on Solana mainnet (base58, 32 bytes). Bad input → 400 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sol_tx

  Use when an agent must confirm a Solana payment or transaction landed: did it succeed, who paid whom, how much of which token. Input: signature. Output: JSON status (success/failed), slot, block time, confirmation status, fee payer, signers, fee, programs, SOL and token balance changes per account (first 25). Unknown signature: 404, not charged. Example: ?signature=5Xg1wCobkM4jAJNHE6t7B1amt4ch5wq5GrxuhQXXgoAkUPUAjVMC9tQFCvp1awUGfrqZY9L9sLdPieJ97DcDjXtC Price: $0.0045 USDC (Base or Solana) via x402.

  Parameters:

  • signature (required) — string — Transaction signature on Solana mainnet (base58, 64 bytes). Unknown or not yet confirmed → 404 (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• llm_model_prices

  Use when an agent must price an LLM call or pick the cheapest model. Input: model (up to 5, comma list) plus optional input_tokens, output_tokens, requests; or no model plus mode, provider, min_context, capabilities (vision, function_calling...). Output: JSON USD per 1M input/output tokens, cached/batch prices, context window, provider, capabilities, cost estimate or cheapest ranking, as_of + source commit. Example: ?model=gpt-4o&input_tokens=12000&output_tokens=800 Price: $0.004 USDC (Base or Solana) via x402.

  Parameters:

  • mode — string — Model type for the cheapest search (default chat; chat includes responses-API models). Ignored when model is given
  • limit — ['number', 'string'] — Max rows per model or in the ranking (default 10)
  • model — string — Model name(s), up to 5 comma-separated (gpt-4o, claude-sonnet-4-5, gemini/gemini-2.5-flash). Also lists the same model at other providers. Omit to rank the cheapest models. Unknown → 400 with suggestions (not charged)
  • provider — string — LiteLLM provider id filter: openai, anthropic, gemini, vertex_ai, bedrock, azure, groq, deepseek, mistral...
  • requests — ['number', 'string'] — Number of requests to multiply the estimate by (default 1)
  • min_context — ['number', 'string'] — Minimum context window (max input tokens)
  • capabilities — string — Comma-separated required capabilities: vision, function_calling, reasoning, prompt_caching, response_schema, pdf_input, audio_input, audio_output, web_search, computer_use, video_input
  • input_tokens — ['number', 'string'] — Input (prompt) tokens per request, for the cost estimate and ranking
  • output_tokens — ['number', 'string'] — Output (completion) tokens per request
  • include_deprecated — string — Include models past their deprecation date in the cheapest search (default false)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• x402_api_recommend

  Use when an agent must pick a paid x402 API for a task. Input: q (task in plain words or keywords), optional max_price (USD), network (base, solana or CAIP-2), limit (1-20). Output: JSON ranked endpoints: resource URL, method, description, price, networks, seller, 30-day payers and calls (Bazaar), seller buyers (x402scan), wash/quality flags, score, index as_of. Same rules for every seller. Example: ?q=base+token+honeypot+check&max_price=0.02 Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • q (required) — string — What the API should do, in plain words or keywords (e.g. 'korean apartment prices', 'convert pdf to markdown'). Text only: never fetched as a URL
  • limit — ['number', 'string'] — Number of results (default 8)
  • network — string — Only endpoints that accept this network: base, solana, polygon, arbitrum, optimism, ethereum, avalanche, worldchain, monad, or a CAIP-2 id (eip155:8453)
  • max_price — ['number', 'string'] — Only endpoints priced at or below this many USD per call
  • include_flagged — string — false drops routes flagged scanner_like or uniform_payers (suspected probes / wash); default true (flagged routes are kept but ranked lower)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hl_perp_metrics

  Hyperliquid vs Binance vs Bybit predicted funding comparison for one perpetual futures market, plus current funding rate, open interest and basis. Use when an agent monitors a perp position or funding carry. Input: coin (e.g. BTC, ETH, kPEPE). Output: JSON as_of, cache_age_s, 1h + annualized funding, OI coin/USD, mark/oracle/mid, basis %, premium, 24h volume and change, per-venue predicted funding, annualized spread. Unknown coin: 400, not charged. Example: ?coin=BTC Price: $0.002 USDC (Base or Solana) via x402.

  Parameters:

  • coin (required) — string — Hyperliquid perp symbol, case-insensitive (BTC, ETH, SOL, HYPE, kPEPE). Not listed or delisted → 400 before payment (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hl_funding_screener

  Perpetual futures funding rate screener over all Hyperliquid perps, ranked by funding, open interest, volume, basis or Binance/Bybit spread. Use when hunting funding extremes or carry trades. Input: optional sort, order, limit (1-50), min_oi_usd, min_volume_usd, funding (positive/negative), min_abs_apr. Output: JSON as_of, cache_age_s, rows (1h + annualized funding, OI USD, 24h volume, basis, premium, venue spread), top/bottom 5. Example: ?sort=funding&limit=20 Price: $0.009 USDC (Base or Solana) via x402.

  Parameters:

  • sort — string — Ranking field (default funding = 1h funding rate)
  • limit — ['number', 'string'] — Rows returned (1-50, default 20)
  • order — string — desc (highest first, default) or asc
  • funding — string — Funding sign filter (positive = longs pay shorts)
  • min_oi_usd — ['number', 'string'] — Only markets with open interest >= this many USD
  • min_abs_apr — ['number', 'string'] — Only markets whose |annualized Hyperliquid funding| >= this percent
  • min_volume_usd — ['number', 'string'] — Only markets with 24h notional volume >= this many USD

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sepolia_eth

  Use when an agent, test suite or CI job needs Sepolia gas now: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 0.1 SepETH (1 SepETH: /v1/testnet/sepolia-eth/1). Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.05 USDC (Base or Solana) via x402.

  Parameters:

  • to (required) — string — Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sepolia_eth_1

  Use when a contract deploy, test suite or CI job needs more Sepolia gas than a faucet gives: one x402 call, no faucet login or mainnet history. Input: to (recipient address); sends 1 SepETH. Output: JSON txHash (confirmed before settling), explorerUrl, amountEth, from, to. Daily limits (UTC): 5 SepETH per address (both sizes), 20 overall; checked before payment. Test ETH has no monetary value. Example: ?to=0x000000000000000000000000000000000000dEaD Price: $0.50 USDC (Base or Solana) via x402.

  Parameters:

  • to (required) — string — Recipient Ethereum address (EIP-55 checksum if mixed case). Bad input, caps reached or out of stock → 4xx/503 before payment (not charged)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• convert_to_markdown

  Use when an agent must read a document as clean Markdown: web page, PDF, DOCX or Korean HWP/HWPX, tables kept. Input: url (http/https) via GET, or POST a file (multipart 'file', raw body, or JSON contentBase64+filename). Free-plan size cap → 413 before payment: HWP 48 KB, HWPX 100 KB XML. Output: JSON markdown, title, pages, sourceType, warnings. Price by detected type: HTML $0.0027, PDF/DOCX $0.0045, HWP/HWPX $0.009. Example: ?url=https://example.com/ Price: $0.0027–$0.009 USDC (Base or Solana) via x402.

  Parameters:

  • url — string — Public http(s) URL of a web page, PDF, DOCX, HWP or HWPX (max 10 MB)
  • type — string — Optional expected type: html, text, pdf, docx, hwp, hwpx
  • filename — string — Original file name, e.g. report.hwp (helps detection)
  • contentBase64 — string — Document bytes as base64 (alternative to url; max 10 MB decoded)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

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