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 — lists the tools exposed by any mcp (model context protocol) server from its url

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Lists the tools exposed by any MCP (Model Context Protocol) server from its URL. Completes the initialize handshake over HTTP transport 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. SSRF-guarded (no loopback / RFC1918 targets). Use it for tools/list JSON-RPC, agent capability discovery, or MCP catalog lookup.

INPUT — request schema

property	type	description	req?
url	string	Full URL to the MCP server's JSON-RPC HTTP endpoint (e.g. 'https://server.example.com/mcp'). http or https only; private/loopback targets rejected.	required
timeout_ms	number	Per-call timeout. Default 12000, max 25000.	optional
list_resources	boolean	Also call resources/list. Default false. Best-effort — many servers don't expose resources.	optional
list_prompts	boolean	Also call prompts/list. Default false. Best-effort.	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.agentutility.ai/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 the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the mcp-tools-list tool from your MCP-aware agent.

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
arxiv-bibtex	Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma…	$0.005
brand-domain-check	Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who…	$0.005
brand-name-score	Scores a candidate brand or startup name on quality and risk.	$0.005
brand-watch-domain-risk	Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses.	$0.005
company-name-score	Scores the quality of a company name before you commit to domain, handle, trademark, and launch work.	$0.005
creator-domain-check	Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags.	$0.005
crypto-headlines	Crypto headlines API for agents that need breaking cryptocurrency news by topic or query.	$0.005
crypto-news	Crypto news API that searches recent cryptocurrency headlines for a topic, token, protocol, or market event.	$0.005