Name: mcp-tools-list
Price: 0.005 USDC
Availability: InStock

$ man mcp-tools-list

agentutility / web-probe / mcp-tools-list

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

mcp-tools-list — mcp tools-list / model context protocol discovery / list mcp server tools / tools/list json-rpc / agent capability discovery / mcp catalo…

SYNOPSIS

POST https://x402.org/v1/mcp-tools-list
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

MCP tools-list / Model Context Protocol discovery / list MCP server tools / tools/list JSON-RPC / agent capability discovery / MCP catalog lookup. Pass any MCP server URL (HTTP transport) — completes the initialize handshake and returns the tool catalog (names, descriptions, JSON-schema input shapes). Optionally also lists resources and prompts. Pure agent infrastructure: an agent that discovers an unknown MCP server URL gets back its capabilities without running its own MCP client. No API key. SSRF-guarded (no loopback / RFC1918 targets).

INPUT — request schema

property	type	description	req?
url	string	Full URL to an MCP server's JSON-RPC HTTP endpoint.	required
timeout_ms	number	Per-call timeout. Default 12000, max 25000.	optional
list_resources	boolean	Also call resources/list. Default false.	optional
list_prompts	boolean	Also call prompts/list. Default false.	optional

OUTPUT — response shape

field	type	description
url	string	MCP server URL that was probed (HTTP transport endpoint passed in the request).
server_info	objectnull	Server identity from the initialize handshake (name, version), or null if the server didn't return one.
capabilities	objectnull	Capabilities object from initialize — which MCP features (tools, resources, prompts) the server advertises.
tools	array	Tool catalog from tools/list — each entry has name, description, and JSON-schema inputSchema.
resources	arraynull	Resource catalog from resources/list if the server supports resources, otherwise null.
prompts	arraynull	Prompt catalog from prompts/list if the server supports prompts, otherwise null.
source	string	Identifier for which probe ran (e.g. mcp-tools-list) for debugging and provenance.
attribution	string	Credit string pointing back to this x402 endpoint as the data source.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/mcp-tools-list \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the mcp-tools-list tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: mcpagenttoolsdiscoveryjson-rpcmodel-context-protocol
methods: POST
cluster: webprobe
price: $0.005 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
disposable-email-check	Disposable email detector / fake email filter / fraud signup defense.	$0.005
domain-availability	Domain availability / RDAP lookup / WHOIS replacement / domain registration checker / expiry date lookup.	$0.005
github-stars-history	GitHub stars history / star growth chart / repo popularity over time / trending tracker.	$0.005
link-extract	Link extractor / extract links from URL / list all anchor links / page outlink crawler / scrape outbound links / get hrefs from page.	$0.005
sitemap-fetch	Sitemap fetcher / sitemap.xml parser / sitemap index resolver / SEO sitemap reader / robots.txt sitemap discovery / website URL inventory.	$0.005
wikipedia	Wikipedia API / encyclopedia lookup.	$0.005
wikipedia-lookup	Wikipedia API / encyclopedia lookup / structured article fetch.	$0.005
homoglyph-check	Homoglyph attack detector / Unicode lookalike scanner.	$0.003

/mcp-tools-list(1)