Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

x402 Agent Hub

by BlackCat-cyber-creatorversion 1.6.0i★ 0iRuns in the cloudOfficial site ↗
Registry nameio.github.BlackCat-cyber-creator/x402-agent-hub

How to install

What it does

Onchain reads, SEC company financials, company & people enrichment, token verdicts via x402 USDC

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Crypto & blockchain

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score20/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install x402 Agent Hub. Follow https://mcp.popnx.com/i/blackcat-cyber-creator-x402-agent-hub.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (x402-agent-hub.x402-agent-hub.workers.dev) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · Namex402 Agent Hub
    Remote MCP server URL · Addresshttps://x402-agent-hub.x402-agent-hub.workers.dev/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +Connectorsx402 Agent Hub

  4. Try it

    Use x402 Agent Hub and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using x402 Agent Hub or shows a x402 Agent Hub tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · Namex402 Agent Hub
    Connection · Addresshttps://x402-agent-hub.x402-agent-hub.workers.dev/mcp
  3. Pick x402 Agent Hub in a chat

    Start a new chat and pick x402 Agent Hub from your plugins before typing

  4. Try it

    Use x402 Agent Hub and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using x402 Agent Hub or shows a x402 Agent Hub tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user x402-agent-hub https://x402-agent-hub.x402-agent-hub.workers.dev/mcp
  3. Type /mcp in Claude Code

    You should see x402 Agent Hub listed as connected

  4. Try it

    Use x402 Agent Hub and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using x402 Agent Hub or shows a x402 Agent Hub tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use x402 Agent Hub and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using x402 Agent Hub or shows a x402 Agent Hub tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use x402 Agent Hub and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using x402 Agent Hub or shows a x402 Agent Hub tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://x402-agent-hub.x402-agent-hub.workers.dev/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use x402 Agent Hub💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user x402-agent-hub https://x402-agent-hub.x402-agent-hub.workers.dev/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "x402-agent-hub": {
      "url": "https://x402-agent-hub.x402-agent-hub.workers.dev/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "x402-agent-hub": {
      "type": "http",
      "url": "https://x402-agent-hub.x402-agent-hub.workers.dev/mcp"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
1.6.0
Published to registryi
Oct 31, 2026
Code last changedi
Nov 18, 2026
Last checked
Nov 17, 2026
Maker
BlackCat-cyber-creator
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 17, 2026. The maker wrote them, not us; we show them as plain text.

  • get_hub_catalog

    FREE ($0.00): Inspect the live x402 Agent Hub service catalog, supported CFD/Forex tickers, per-call Base USDC pricing, and OpenAPI URL.

  • get_ict_sessions

    Get live ICT Killzones (Asian, London Open, NY Open, London Close), 60m Silver Bullet FVG windows, CFD rollover spread-danger alerts, and Wednesday/Friday triple-swap flags ($0.005 USDC on Base).

  • get_cfd_microstructure

    Get institutional ECN calibrated spreads, round-turn commissions, M1 ATR, spread-to-ATR execution cost ratios across M1-H1, scalping suitability, and live MT5 FVGs for XAUUSD, BTCUSD, NAS100, US30, US500, GER40, JPN225, USOUSD, EURUSD, GBPUSD, USDJPY ($0.01 USDC on Base).

  • calculate_prop_firm_risk

    Calculate exact CFD/Forex lot size factoring ECN spread+commission friction and prop-firm daily/max drawdown auto-lock status ($0.01 USDC on Base).

  • extract_clean_markdown

    Fetch any public webpage and convert it into clean, token-efficient LLM Markdown with metadata and token count ($0.005 USDC on Base).

  • enrich_business_lead

    Enrich a business URL for SDR/sales outreach: sanitize brand names, detect phantom wa.me/linktr.ee/marketplace links, extract normalized E.164 WhatsApp/mobile phones (rejecting office PSTN landlines), find emails/socials, and detect CMS/analytics pixels ($0.015 USDC on Base).

  • audit_technical_seo

    Run an instant 0-100 Technical SEO & Website Modernization Audit scorecard with prioritized fixes ($0.02 USDC on Base).

  • render_visual_card

    Render a deterministic, typo-free 1200x630 OpenGraph banner, 1080x1350 social KPI slide, or trading signal sparkline card as SVG + data URI ($0.025 USDC on Base).

  • audit_crypto_token

    Audit any Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, or Solana token contract for honeypots, buy/sell taxes, hidden ownership, whale concentration, LP locks, live DEX liquidity depth, and AMM slippage impact for an intended USD order size. On Base, Ethereum, BSC

  • generate_outreach_dossier

    Generate a complete B2B SDR Outreach Dossier in 1 call: Brand Sanitizer, Phantom Lead Shield, E.164 WhatsApp/email contacts, CMS/pixel stack, 0-100 Technical SEO revenue-leak audit, and ready-to-send personalized WhatsApp & Cold Email scripts ($0.05 USDC on Base).

  • chain_native_balance

    Native coin balance of any address on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC or Avalanche, with raw wei and formatted units plus the block it was read at. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement. ($0.002 USDC on

  • chain_token_balance

    ERC-20 token balance of any address on 7 EVM chains, returned raw and decimal-formatted with the token symbol, so agents never mis-scale USDC (6) vs 18-decimal tokens. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement. ($0.002 USDC

  • chain_token_info

    ERC-20 token metadata on 7 EVM chains: name, symbol, decimals and formatted total supply in one call. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement. ($0.002 USDC on Base)

  • chain_transaction_status

    Status of any transaction on 7 EVM chains: pending / success / reverted, confirmations, block time, from/to, value and the all-in fee (including the OP-stack L1 data fee on Base and Optimism). Use it to confirm a payment or deployment landed. You only pay for successful reads: in

  • chain_address_info

    Classify any address on 7 EVM chains before interacting with it: EOA, EIP-7702-delegated EOA or contract, code size, nonce, native balance, and proxy detection (EIP-1967 implementation/admin/beacon slots, legacy ZeppelinOS proxies such as USDC, and EIP-1167 minimal proxies). You

  • chain_ens_resolve

    Resolve an ENS name to an address, or an address to its primary ENS name, via the Ethereum mainnet Universal Resolver (CCIP-read / offchain names supported). Pass exactly one of 'name' or 'address'. You only pay for successful reads: invalid input, not-found and upstream errors c

  • chain_portfolio

    One call returns an address's native coin, USDC and USDT balances on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC and Avalanche (or a 'chains' subset), plus a total stablecoin USD figure, instead of 21 separate reads. Chains whose RPC fails are listed in chainsFailed. You onl

  • company_search

    Search ~10,000 SEC-registered US public companies by ticker or name and get the ticker, legal name and CIK to use with the other company tools. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement. ($0.002 USDC on Base)

  • company_profile

    Official SEC profile of a US public company: legal name, tickers, exchanges, SIC industry, state of incorporation, fiscal year end, website, business address, former names, and direct links to its latest annual, quarterly and current reports. You only pay for successful reads: in

  • company_financials

    Reported fundamentals for US-GAAP filers from SEC XBRL data: revenue, operating income, net income, diluted EPS, operating cash flow, capex, free cash flow, total assets/liabilities, equity, cash, margins and YoY revenue growth for the last 1-12 annual or quarterly periods. Q4 an

  • company_filings

    A company's most recent SEC filings, optionally filtered by form type (e.g. 10-K,8-K) and date, with filing/report dates, 8-K item numbers and direct links to the document and filing index. You only pay for successful reads: invalid input, not-found and upstream errors cancel set

  • company_insider_trades

    Parsed SEC Form 4 insider filings for a company: insider name and role (director, officer title, 10% owner), transaction code (open-market buy/sell, award, exercise, tax withholding...), shares, price, USD value, holdings after, 10b5-1 plan flag, plus a buy/sell summary. You only

  • entity_search

    Search Wikidata for companies, notable people or anything else by name and get IDs, short descriptions and Wikipedia links, so you can pick the right entity before enriching it. You only pay for successful reads: invalid input, not-found and upstream errors cancel settlement. ($0

  • entity_company

    Enrich any company worldwide (private, startup or listed; not just US) by name, website domain or Wikidata ID: website, founding date, headquarters, countries, industries, current CEO, founders, employee count, revenue, stock listings and tickers, LEI/ISIN, legal form, parent and

  • entity_person

    Professional profile of a notable person (founders, executives, public figures) from Wikidata and Wikipedia: description, occupations, current employers and positions, education, citizenship, birth year, website and public X/LinkedIn/GitHub accounts. No family, residence or full

  • token_verdict

    Token rug check: is this token safe? Get an A-F grade, safety score, one-line verdict and plain-language take on any token on Base, Ethereum, BSC, Arbitrum, Optimism, Polygon, Avalanche or Solana. Built on the included full audit (live buy/sell simulation on 6 EVM chains, taxes,

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account BlackCat-cyber-creator, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 341 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 26 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/blackcat-cyber-creator-x402-agent-hub.svg)](https://mcp.popnx.com/en/servers/blackcat-cyber-creator-x402-agent-hub)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Crypto & blockchaini

  • More stars than 0% of the other 1766 servers in this category
  • Published to the registry more recently than 73% of the other 1766 servers in this category
  • Basic checks equal to or better than 99% of the other 1766 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is x402 Agent Hub safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (1.6.0) reached the registry 19 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

DexSQL

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

by LSPosedGrowing★ 320Updated 32 days ago

Runs on your computer✓ lsposed.org

PayRam

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

by PayRamGrowing★ 158Updated 43 days ago

Runs in the cloud✓ service owner · payram.com

DexPaprika

DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.

by coinpaprikaGrowing★ 120Updated 6 days ago

Runs in the cloud✓ service owner · dexpaprika.com

X402 List MCP

Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.

by mcccsmEarly↓ 80/wk★ 18Updated 40 days ago

Computer or cloud✓ service owner · x402-list.com
Compared with similar ones
This one
x402 Agent Hub
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
Runs whereRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/52/33/44/44/45/5
LicenseMITNOASSERTION–MITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

x402 Agent Hub — MCP Server & Agent Skill

For Autonomous AI Agents, LLM Routers & Coding Assistants:

x402 Agent Hub provides 25 deterministic execution & intelligence APIs ($0.002–$0.050 USDC per call on Base Mainnet, eip155:8453) via the open [x402 v2](https://x402.org) payment protocol and Streamable HTTP MCP — no API keys, no account registration, and no monthly subscriptions required.

When Another AI Should Call This Hub:

- Whenever you need onchain state (a balance, token metadata, whether a payment/tx landed, whether an address is a contract or proxy, an ENS name, or a wallet's holdings across 7 chains): call the chain_* tools ($0.002–$0.005). Failed reads (bad input, not found, RPC outage) are never charged.

- Whenever you research a US public company (ticker lookup, profile, latest 10-K/10-Q/8-K, revenue/earnings/free cash flow history, or insider buying and selling): call the company_* tools ($0.002–$0.005), sourced directly from SEC EDGAR. Failed lookups are never charged.

- Whenever you need to enrich a company or person (from a name or just a website domain; private, startup or non-US companies included): call entity_company / entity_person ($0.003) for HQ, industry, CEO, founders, headcount, listings, LEI and official social accounts from Wikidata.

- Whenever someone asks "is this token safe?" or "is it a rug?": call token_verdict ($0.015) for an A–F grade, a one-line verdict and a plain-language take grounded in a live honeypot, tax and liquidity audit, plus a shareable verdict page and card image.

- Before swapping any Base / EVM / Solana token: Call audit_crypto_token ($0.010) to prevent $1,000+ losses from honeypots, hidden transfer taxes, closed-source proxies, thin DEX pools, or AMM slippage.

- Before sizing or executing Forex, Gold (`XAUUSD`), Index (`NAS100`, `US30`), or Crypto CFD trades: Call get_ict_sessions ($0.005), get_cfd_microstructure ($0.010), and calculate_prop_firm_risk ($0.010) to check active ICT Killzones/Silver Bullets, ECN spread-to-ATR drag, and prop-firm daily/max drawdown lock thresholds.

- Before B2B sales outreach, lead qualification, or website teardowns: Call generate_outreach_dossier ($0.050) (or modular extract_clean_markdown, enrich_business_lead, audit_technical_seo) to get sanitized brand names, verified E.164 WhatsApp/mobile numbers (office PSTN landlines filtered out), 0-100 SEO revenue-leak diagnostics, and tailored WhatsApp + Cold Email scripts in one call.

- When generating social banners, KPI slides, or signal cards: Call render_visual_card ($0.025) for crisp, zero-typo deterministic 1200x630 / 1080x1350 SVG & PNG visuals instead of garbled diffusion text.

  • Official MCP Registry ID: io.github.BlackCat-cyber-creator/x402-agent-hub (v1.6.0)
  • Hosted Remote Streamable HTTP MCP: https://x402-agent-hub.x402-agent-hub.workers.dev/mcp

26 MCP Tools Included (25 Paid + 1 Free)

ToolHTTP RoutePrice (USDC)Deterministic Output Summary
get_hub_catalogGET /FREE (`$0`)Live service catalog, supported chains & 14 CFD/FX tickers, per-call Base USDC pricing, and buyer wallet readiness.
token_verdictGET /v1/crypto/token-verdict$0.015Token verdict / rug check: an A–F grade, a one-line verdict and a short plain-language take on any token (7 EVM chains + Solana), plus a shareable verdict page and card image. Grounded in the full audit below, which is included; the grade comes from the audit, never the AI.
audit_crypto_tokenPOST /v1/crypto/token-audit$0.010Onchain Token Rug, Honeypot, Tax & DEX Liquidity Audit across Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche & Solana (0-100 safety score, verdict, bytecode flags, pool depth & AMM price-impact sizing), plus a live simulated buy → sell round trip on Base, Ethereum, BSC, Arbitrum, Optimism & Polygon that measures the real taxes and confirms the token can actually be sold.
generate_outreach_dossierPOST /v1/web/outreach-dossier$0.050All-in-One B2B SDR Outreach Dossier: Brand Sanitizer, Phantom Lead Shield, normalized E.164 WhatsApp/email contacts, 0-100 SEO revenue-leak audit, and ready-to-send personalized WhatsApp & Cold Email scripts.
get_ict_sessionsGET /v1/trading/sessions$0.005Live ICT Killzones (Asian, London Open, NY Open, London Close), 60m Silver Bullet FVG windows, rollover spread-danger alerts, and Wednesday/Friday triple-swap flags.
get_cfd_microstructureGET /v1/trading/microstructure$0.010Tick-calibrated ECN spreads, round-turn commissions, M1 ATR, M1–H1 spread-to-ATR execution ratios, and scalping suitability across 14 symbols (XAUUSD, BTCUSD, NAS100, US30, US500, GER40, JPN225, USOUSD, EURUSD, GBPUSD, USDJPY, etc.).
calculate_prop_firm_riskPOST /v1/trading/prop-risk$0.010Exact lot-size calculator factoring ECN spread+commission friction plus prop-firm daily/max drawdown auto-lock protection.
extract_clean_markdownPOST /v1/web/extract$0.005Convert any public URL into clean, token-efficient LLM Markdown with metadata & token estimate.
enrich_business_leadPOST /v1/web/lead-enrich$0.015SDR business domain enricher: Brand Sanitizer, Phantom Lead Shield (wa.me / linktr.ee / marketplace detector), normalized E.164 WhatsApp/mobile phones (rejecting office PSTN landlines), emails, socials & CMS/pixel stack.
audit_technical_seoPOST /v1/web/seo-audit$0.020Instant 0-100 Technical SEO & Website Modernization Audit with prioritized fixes.
render_visual_cardPOST /v1/render/card$0.025Deterministic, typo-free 1200x630 OpenGraph banner, 1080x1350 social KPI slide, or trading sparkline card (SVG + data URI).
chain_native_balanceGET /v1/chain/balance$0.002Native coin balance (ETH, BNB, POL, AVAX) of any address on 7 EVM chains, raw + formatted.
chain_token_balanceGET /v1/chain/token-balance$0.002ERC-20 balance already scaled by the token's decimals (no USDC 6-vs-18 mistakes).
chain_token_infoGET /v1/chain/token-info$0.002ERC-20 name, symbol, decimals and formatted total supply.
chain_transaction_statusGET /v1/chain/tx$0.002Pending / success / reverted, confirmations, block time, value and all-in fee (incl. OP-stack L1 data fee).
chain_address_infoGET /v1/chain/address-info$0.003EOA vs EIP-7702-delegated EOA vs contract, nonce, balance, proxy implementation (EIP-1967, ZeppelinOS e.g. USDC, EIP-1167).
chain_ens_resolveGET /v1/chain/ens$0.002ENS forward (name → address) or reverse (address → primary name) via the Universal Resolver.
chain_portfolioGET /v1/chain/portfolio$0.005One call for native + USDC/USDT balances on Base, Ethereum, Arbitrum, Optimism, Polygon, BSC & Avalanche, with total stablecoin USD.
company_searchGET /v1/company/search$0.002Find a US public company's ticker, legal name, exchange and SEC CIK by name.
company_profileGET /v1/company/profile$0.002SEC profile: industry, exchanges, fiscal year end, address and links to the latest 10-K / 10-Q / 8-K.
company_financialsGET /v1/company/financials$0.005Annual or quarterly revenue, net income, EPS, cash flow, free cash flow, balance sheet, margins and YoY growth from SEC XBRL (Q4 derived and flagged).
company_filingsGET /v1/company/filings$0.002Latest 10-K / 10-Q / 8-K / S-1 filings with 8-K item numbers and direct document links.
company_insider_tradesGET /v1/company/insider-trades$0.005Parsed Form 4 insider trades: who bought or sold, shares, price, USD value, 10b5-1 flag, plus a buy/sell summary.
entity_searchGET /v1/entity/search$0.002Find companies or notable people by name, with Wikidata IDs to disambiguate.
entity_companyGET /v1/entity/company$0.003Worldwide company enrichment by name or domain (private and non-US too): HQ, industry, CEO, founders, headcount, revenue, listings, LEI, official socials, logo.
entity_personGET /v1/entity/person$0.003Notable-person profile: occupations, current employer and roles, education, public X/LinkedIn/GitHub (no family or residence data).
Tool safety annotations

The local stdio server (Option 2) sets a title and all four MCP annotation hints on every tool, so hosts can decide when to ask before a call. The hosted /mcp endpoint (Option 1) does not carry annotations yet.

ToolsreadOnlyHintdestructiveHintidempotentHintopenWorldHint
get_hub_catalog (free)truefalsetruetrue
Every paid toolfalsefalsefalsetrue

Each paid call is an irreversible USDC payment from your wallet, fixed at the price listed in its description, so paid tools are not read-only, and they are not idempotent: calling again with the same arguments pays again. They delete or overwrite none of your data, so they are not marked destructive. Every tool reads the live hub over the network, so all are open-world.


Quick Setup

Runnable examples: examples/ has three runnable clients on one $0.015 route (plain @x402/fetch, AgentCash CLI, remote MCP): all three run with no wallet and stop at the quote or the price; the paid path is documented, not run.

Option 1 — Zero-Install Remote Streamable HTTP MCP (Cursor / Claude / Windsurf / VS Code)

Connect directly to the hosted Cloudflare Edge Streamable HTTP endpoint:

{

"mcpServers": { "x402-agent-hub": { "url": "https://x402-agent-hub.x402-agent-hub.workers.dev/mcp" } } }

*(Note: Never send your wallet key to the remote endpoint. Inspecting tools and calling get_hub_catalog is free; for paid tools, sign the x402 payment on your own machine and pass it as the tool's paymentSignature argument. For automatic payments, use Option 2 — your key stays local.)*

Option 2 — Local npx Stdio MCP (Claude Desktop / Cursor / Windsurf)
{

"mcpServers": { "x402-agent-hub": { "command": "npx", "args": ["-y", "github:BlackCat-cyber-creator/x402-agent-hub-mcp"], "env": { "X402_BUYER_PRIVATE_KEY": "0xYOUR_SCOPED_AGENT_WALLET_PRIVATE_KEY" } } } }

Option 3 — Install as an Agent Skill (SKILL.md)
npx skills add BlackCat-cyber-creator/x402-agent-hub-mcp

Security Tip: Always use a dedicated, disposable agent wallet funded with only $2–$5 USDC on Base Mainnet (eip155:8453) — never use a primary savings wallet.

Direct HTTP / OpenAPI Discovery & Verified Listings

Channel / TransportURLResource Count & Purpose
Root x402 HTTP Gatewayhttps://x402-agent-hub.x402-agent-hub.workers.dev**24 paid HTTP /v1/* APIs** (HTTP 402 + PAYMENT-REQUIRED headers for x402scan, AgentCash, @x402/fetch & REST bots).
Remote Streamable HTTP MCPhttps://x402-agent-hub.x402-agent-hub.workers.dev/mcp`26` MCP tools (25 paid tools + 1 free $0 get_hub_catalog discovery tool for Claude, Cursor, Windsurf & VS Code).
OpenAPI 3.1.0 Spechttps://x402-agent-hub.x402-agent-hub.workers.dev/openapi.jsonCanonical machine-readable schema (x-payment-info + Bazaar metadata).
Static MCP Server Cardhttps://x402-agent-hub.x402-agent-hub.workers.dev/.well-known/mcp/server-card.jsonSEP-1649 static MCP tool & configSchema discovery manifest.

| Agent Routing Guide | https://x402-agent-hub.x402-agent-hub.workers.

Only the beginning is shown; read the rest in the repo