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-name-score	Scores a candidate brand or startup name on quality and risk.	$0.005
company-name-score	Scores the quality of a company name before you commit to domain, handle, trademark, and launch work.	$0.005
crypto-headlines	Searches recent bitcoin, ethereum, and DeFi headlines via GDELT with a GNews fallback when configured, returning headline URLs, domains,…	$0.005
crypto-news	Fetches recent cryptocurrency news headlines from GDELT with a GNews fallback when configured, filtered by crypto topic or caller query,…	$0.005
disposable-email-check	Detects disposable and throwaway email addresses before they get through your signup form.	$0.005
domain-availability	Checks whether a domain is registered and returns registrar, registration date, expiry date, days_until_expiry, and current EPP status flags.	$0.005
email	Validates an email address end to end: syntax, MX reachability, disposable/temp-mail domains, role accounts, and SPF/DMARC/DKIM posture.	$0.005