Agent402.Tools: payments and trust for AI agents is an MCP server published by io.github.MikeyPetrillo, hosted at agent402.tools. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 16 tools, including catalog.search, catalog.find, catalog.call, payment.info, web.search.
Payment and trust layer for agent commerce (Agentic Finance): pay and verify calls over x402 and MPP
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Keyword search over the Agent402 catalog of 500+ tools (636 loaded by this connector). Returns { results, workflows }; run one with catalog.call. 177 pure-CPU tools run free here (proof-of-work). The others are paid per call, payable here in the call over x402 or MPP (the payment rides in _meta), or through npx agent402-mcp with a wallet.
| Parameter | Type | Description |
|---|---|---|
| limit | number | Max results (default 10) |
| query * | string | What you need, e.g. "search the web for x402", "answer a question with citations", "decode JWT" |
{
"name": "catalog.search",
"title": "Search the Agent402 tool catalog",
"description": "Keyword search over the Agent402 catalog of 500+ tools (636 loaded by this connector). Returns { results, workflows }; run one with catalog.call. 177 pure-CPU tools run free here (proof-of-work). The others are paid per call, payable here in the call over x402 or MPP (the payment rides in _meta), or through npx agent402-mcp with a wallet.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"description": "Max results (default 10)"
},
"query": {
"type": "string",
"description": "What you need, e.g. \"search the web for x402\", \"answer a question with citations\", \"decode JWT\""
}
}
},
"outputSchema": {
"type": "object",
"required": [
"results"
],
"properties": {
"hint": {
"type": "string",
"description": "Shown when the match is weak - points at demand.request"
},
"usage": {
"type": "string"
},
"message": {
"type": "string",
"description": "Present when nothing matched"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Catalog tool slug (kebab-case)"
},
"price": {
"type": "string",
"description": "List price, e.g. $0.001"
},
"access": {
"type": "string",
"description": "free here vs wallet required"
},
"example": {
"description": "Worked example input"
},
"callWith": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
}
},
"description": "Ready-to-run catalog.call invocation"
},
"required": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"inputSchema": {
"type": "object",
"description": "JSON Schema for the tool's params",
"additionalProperties": true
}
}
},
"description": "Matching catalog tools"
},
"workflows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"price": {
"type": "string"
},
"route": {
"type": "string"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"tagline": {
"type": "string"
},
"toolCount": {
"type": "integer"
},
"promptName": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Matching skill-pack workflows"
},
"workflowsUsage": {
"type": "string"
}
}
},
"annotations": {
"title": "Search the Agent402 tool catalog",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resolve a plain-language task to the single best-matching Agent402 tool, returned call-ready: slug, price, input schema and a worked example. Use catalog.search to compare several candidates. Returns { task, results } with the top pick first; run it with catalog.call and the slug and params it lists.
| Parameter | Type | Description |
|---|---|---|
| task * | string | What you want to do, e.g. "search the web for x402 adoption" or "convert miles to km" |
| limit | number | Max results (default 5) |
{
"name": "catalog.find",
"title": "Resolve a task to the one best Agent402 tool",
"description": "Resolve a plain-language task to the single best-matching Agent402 tool, returned call-ready: slug, price, input schema and a worked example. Use catalog.search to compare several candidates. Returns { task, results } with the top pick first; run it with catalog.call and the slug and params it lists.",
"inputSchema": {
"type": "object",
"required": [
"task"
],
"properties": {
"task": {
"type": "string",
"description": "What you want to do, e.g. \"search the web for x402 adoption\" or \"convert miles to km\""
},
"limit": {
"type": "number",
"description": "Max results (default 5)"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"task"
],
"properties": {
"hint": {
"type": "string"
},
"plan": {
"type": "object",
"description": "Present when the task names several steps: each step ranked by this free search (no model), with an estimated total and the paid decide upgrade",
"additionalProperties": true
},
"task": {
"type": "string"
},
"usage": {
"type": "string"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Catalog tool slug (kebab-case)"
},
"price": {
"type": "string",
"description": "List price, e.g. $0.001"
},
"access": {
"type": "string",
"description": "free here vs wallet required"
},
"example": {
"description": "Worked example input"
},
"callWith": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
}
},
"description": "Ready-to-run catalog.call invocation"
},
"required": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"inputSchema": {
"type": "object",
"description": "JSON Schema for the tool's params",
"additionalProperties": true
}
}
},
"description": "Alias of results on the stdio package"
},
"message": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Catalog tool slug (kebab-case)"
},
"price": {
"type": "string",
"description": "List price, e.g. $0.001"
},
"access": {
"type": "string",
"description": "free here vs wallet required"
},
"example": {
"description": "Worked example input"
},
"callWith": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
}
},
"description": "Ready-to-run catalog.call invocation"
},
"required": {
"type": "array",
"items": {
"type": "string"
}
},
"description": {
"type": "string"
},
"inputSchema": {
"type": "object",
"description": "JSON Schema for the tool's params",
"additionalProperties": true
}
}
},
"description": "Ranked matches; top pick first"
},
"workflows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"price": {
"type": "string"
},
"route": {
"type": "string"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"tagline": {
"type": "string"
},
"toolCount": {
"type": "integer"
},
"promptName": {
"type": "string"
}
},
"additionalProperties": true
}
},
"relatedSellers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"workflowsUsage": {
"type": "string"
}
}
},
"annotations": {
"title": "Resolve a task to the one best Agent402 tool",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Run an Agent402 tool by slug, with params matching that tool's inputSchema; find slugs with catalog.find or catalog.search. The 177 pure-CPU tools run free here, rate-limited, through proof-of-work. Paid tools are payable here, in the call, over x402 or MPP (the first answer carries the ask). An unknown slug returns an error.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Tool slug, e.g. "search" or "unit-convert" |
| params | object | Tool input, matching the tool's inputSchema |
{
"name": "catalog.call",
"title": "Run an Agent402 tool",
"description": "Run an Agent402 tool by slug, with params matching that tool's inputSchema; find slugs with catalog.find or catalog.search. The 177 pure-CPU tools run free here, rate-limited, through proof-of-work. Paid tools are payable here, in the call, over x402 or MPP (the first answer carries the ask). An unknown slug returns an error.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Tool slug, e.g. \"search\" or \"unit-convert\""
},
"params": {
"type": "object",
"description": "Tool input, matching the tool's inputSchema"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"slug",
"result"
],
"properties": {
"slug": {
"type": "string",
"description": "Catalog slug that ran"
},
"result": {
"description": "Native tool output (shape depends on slug)",
"additionalProperties": true
},
"answerBound": {
"type": "object",
"description": "Present only when a free answer was cut to the connector's size ceiling: unit, maxBytes, returned, matched, complete, truncated, cuts (one entry per cut list, string or object: path, kind, returned, matched, complete, truncated), cutsListed (entries in cuts) and cutsTotal (every cut made)",
"additionalProperties": true
}
},
"description": "Envelope around the invoked catalog tool's native JSON result"
},
"annotations": {
"title": "Run an Agent402 tool",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}How paying for Agent402 tools works. This connector holds no wallet: 177 pure-CPU tools run free through proof-of-work, and the rest settle in USDC over x402 or MPP (payable here, in the call, over x402 or MPP). Covers wallet setup, per-call and session spend caps, the payment rails, and checking a wallet's balance. Returns { connector, freeTier, pay, spendControls, balanceAndHistory }.
No parameters.
{
"name": "payment.info",
"title": "Payment and wallet setup",
"description": "How paying for Agent402 tools works. This connector holds no wallet: 177 pure-CPU tools run free through proof-of-work, and the rest settle in USDC over x402 or MPP (payable here, in the call, over x402 or MPP). Covers wallet setup, per-call and session spend caps, the payment rails, and checking a wallet's balance. Returns { connector, freeTier, pay, spendControls, balanceAndHistory }.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"pay": {
"type": "object",
"additionalProperties": true
},
"mode": {
"type": "string"
},
"note": {
"type": "string"
},
"tools": {
"type": "integer"
},
"wallet": {
"description": "EVM address when a key is configured"
},
"install": {
"type": "object",
"additionalProperties": true
},
"network": {
"type": "string"
},
"service": {
"type": "string"
},
"freeTier": {
"type": "object",
"additionalProperties": true
},
"networks": {
"type": "array",
"items": {
"type": "string"
}
},
"connector": {
"type": "string"
},
"ecosystem": {
"type": "string"
},
"workflows": {
"description": "Skill-pack count or detail object"
},
"walletOnly": {
"type": "integer"
},
"emptyWallet": {
"type": "object",
"description": "What to do with an empty wallet: state, whoActs, command, wait",
"additionalProperties": true
},
"positioning": {
"type": "string"
},
"mppStartHere": {
"type": "object",
"description": "MPP start-here routes (slug, method, path, url, price, why)",
"additionalProperties": true
},
"solanaWallet": {
"description": "Solana address when a key is configured"
},
"spendControls": {
"additionalProperties": true
},
"balanceAndHistory": {
"type": "object",
"additionalProperties": true
},
"payableWithCompute": {
"type": "integer"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Payment and wallet setup",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Paid ($0.01/call): Live web search: ranked results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO)} from an independent search index as clean JSON - fresh pages your model's training cutoff has never seen. Optional freshness filter (pd/pw/pm/py = past day/week/month/year). It DISCOVERS pages; extract then reads the winner.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Search query (max 400 chars) |
| count | number | Results to return, 1-20 (default 10) |
| freshness | string | Optional: pd, pw, pm, or py (past day/week/month/year) |
{
"name": "web.search",
"title": "Web search",
"description": "Paid ($0.01/call): Live web search: ranked results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO)} from an independent search index as clean JSON - fresh pages your model's training cutoff has never seen. Optional freshness filter (pd/pw/pm/py = past day/week/month/year). It DISCOVERS pages; extract then reads the winner.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query (max 400 chars)"
},
"count": {
"type": "number",
"description": "Results to return, 1-20 (default 10)"
},
"freshness": {
"type": "string",
"description": "Optional: pd, pw, pm, or py (past day/week/month/year)"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"query",
"results"
],
"properties": {
"count": {
"type": "integer"
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"age": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
}
}
}
},
"untrustedContent": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Web search",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.08/call): AI-generated answer to a natural-language question, grounded in live web search results with source citations. Returns clean prose plus a structured citations array (URL, snippet, favicon) - backed by an independent search index, not the model's training data. Useful when an agent needs a synthesized answer plus the receipts to verify or follow up.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Natural-language question (max 400 chars) |
| country | string | Optional 2-letter country code (default us) |
| language | string | Optional 2-letter language code (default en) |
| max_tokens | integer | Optional cap on the generated answer length in tokens (default 1024, min 64, max 4096). Lower for TL;DR; higher for research questions. |
{
"name": "web.answer",
"title": "Web answer",
"description": "Paid ($0.08/call): AI-generated answer to a natural-language question, grounded in live web search results with source citations. Returns clean prose plus a structured citations array (URL, snippet, favicon) - backed by an independent search index, not the model's training data. Useful when an agent needs a synthesized answer plus the receipts to verify or follow up.",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Natural-language question (max 400 chars)"
},
"country": {
"type": "string",
"description": "Optional 2-letter country code (default us)"
},
"language": {
"type": "string",
"description": "Optional 2-letter language code (default en)"
},
"max_tokens": {
"type": "integer",
"description": "Optional cap on the generated answer length in tokens (default 1024, min 64, max 4096). Lower for TL;DR; higher for research questions."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"query",
"answer"
],
"properties": {
"query": {
"type": "string"
},
"share": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": "string"
},
"cardUrl": {
"type": "string"
},
"expiresAt": {
"type": "string"
}
}
},
"answer": {
"type": "string"
},
"citations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"number": {
"type": "integer"
},
"favicon": {
"type": "string"
},
"snippet": {
"type": "string"
}
},
"additionalProperties": true
}
},
"citationCount": {
"type": "integer"
}
}
},
"annotations": {
"title": "Web answer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.01/call): Live news search: ranked recent articles as results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO), source (publisher hostname), breaking} from an independent search index as clean JSON. Same freshness filter as web search (pd/pw/pm/py = past day/week/month/year).
| Parameter | Type | Description |
|---|---|---|
| q * | string | Search query (max 400 chars) |
| count | number | Results to return, 1-50 (default 10) |
| country | string | Optional 2-letter country code (default US) |
| freshness | string | Optional: pd, pw, pm, or py (past day/week/month/year) |
{
"name": "web.news",
"title": "News search",
"description": "Paid ($0.01/call): Live news search: ranked recent articles as results[] of {title, url, description (the snippet, plain text), age, publishedAt (ISO), source (publisher hostname), breaking} from an independent search index as clean JSON. Same freshness filter as web search (pd/pw/pm/py = past day/week/month/year).",
"inputSchema": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query (max 400 chars)"
},
"count": {
"type": "number",
"description": "Results to return, 1-50 (default 10)"
},
"country": {
"type": "string",
"description": "Optional 2-letter country code (default US)"
},
"freshness": {
"type": "string",
"description": "Optional: pd, pw, pm, or py (past day/week/month/year)"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"query",
"results"
],
"properties": {
"count": {
"type": "integer"
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"age": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"breaking": {
"type": "boolean"
},
"description": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
}
}
},
"annotations": {
"title": "News search",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.003/call): Read a page as clean markdown, rendering it in a real headless Chromium browser (JavaScript executed) when the page needs it. Use this for SPAs and JS-heavy sites where plain fetching returns an empty shell; a page whose served HTML already carries its content is read without the browser, faster, and answers rendered: false.
| Parameter | Type | Description |
|---|---|---|
| url * | string | Public http(s) URL to render |
{
"name": "browser.render",
"title": "Browser render",
"description": "Paid ($0.003/call): Read a page as clean markdown, rendering it in a real headless Chromium browser (JavaScript executed) when the page needs it. Use this for SPAs and JS-heavy sites where plain fetching returns an empty shell; a page whose served HTML already carries its content is read without the browser, faster, and answers rendered: false.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Public http(s) URL to render"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"url",
"markdown"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string"
},
"markdown": {
"type": "string"
},
"rendered": {
"type": "boolean"
},
"wordCount": {
"type": "integer"
},
"untrustedContent": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Browser render",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.030/call): Transcribe audio to text with the gpt-transcribe model. Provide a URL to an audio file (mp3, wav, m4a, etc.) and get back the transcript. Add diarize:true for speaker labels, word timestamps and a language confidence score (the scribe-v2 model, same price). No API key needed; pay per call via x402.
| Parameter | Type | Description |
|---|---|---|
| url * | string | URL of the audio file to transcribe (mp3, wav, m4a, ogg, flac, webm) |
| diarize | boolean | true: transcribe with the scribe-v2 model and add speaker labels and word timestamps (`words`, `speakers`) and `language_confidence` (0 to 1, the model's confidence in the detected language). Same price and cap. Default false |
| language | string | Optional ISO-639-1 language code (e.g. 'en', 'es', 'fr') for better accuracy |
{
"name": "audio.transcribe",
"title": "Speech-to-text",
"description": "Paid ($0.030/call): Transcribe audio to text with the gpt-transcribe model. Provide a URL to an audio file (mp3, wav, m4a, etc.) and get back the transcript. Add diarize:true for speaker labels, word timestamps and a language confidence score (the scribe-v2 model, same price). No API key needed; pay per call via x402.",
"inputSchema": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "URL of the audio file to transcribe (mp3, wav, m4a, ogg, flac, webm)"
},
"diarize": {
"type": "boolean",
"description": "true: transcribe with the scribe-v2 model and add speaker labels and word timestamps (`words`, `speakers`) and `language_confidence` (0 to 1, the model's confidence in the detected language). Same price and cap. Default false"
},
"language": {
"type": "string",
"description": "Optional ISO-639-1 language code (e.g. 'en', 'es', 'fr') for better accuracy"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"model": {
"type": "string"
},
"duration": {
"type": "number"
},
"language": {
"type": "string"
},
"provider": {
"type": "string"
},
"durationUnconfirmed": {
"type": "boolean",
"description": "Present (true) only with trimmedToCapSeconds: the file's full length was not confirmed"
},
"trimmedToCapSeconds": {
"type": "number",
"description": "Present only when the file's length could not be confirmed: the audio was transcribed up to this many seconds (the tier's cap)"
}
}
},
"annotations": {
"title": "Speech-to-text",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.001/call): Read from a wallet-scoped namespace. ?key=… returns the stored value; omit key to list keys. The read half of memory-write's exact-key store. For similarity retrieval over remembered text, call the catalog slug memory-recall (on MCP, through catalog.call). Reads your own namespace by default; add ?owner=0x… to read a namespace you've been granted access to.
| Parameter | Type | Description |
|---|---|---|
| key | string | Key to read; omit to list all keys |
| owner | string | Optional 0x namespace to read (requires a grant) |
{
"name": "memory.read",
"title": "Memory read",
"description": "Paid ($0.001/call): Read from a wallet-scoped namespace. ?key=… returns the stored value; omit key to list keys. The read half of memory-write's exact-key store. For similarity retrieval over remembered text, call the catalog slug memory-recall (on MCP, through catalog.call). Reads your own namespace by default; add ?owner=0x… to read a namespace you've been granted access to.",
"inputSchema": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Key to read; omit to list all keys"
},
"owner": {
"type": "string",
"description": "Optional 0x namespace to read (requires a grant)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"exp": {
"description": "Expiry unix seconds or null"
},
"key": {
"type": "string"
},
"keys": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Present in list mode (no key)"
},
"owner": {
"type": "string"
},
"value": {
"description": "Stored JSON value when reading a key"
},
"updated": {
"type": "number"
},
"persistent": {
"type": "boolean"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Memory read",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.001/call): Persistent key-value memory for agents, scoped to the paying wallet. Your x402 payment IS your authentication: the wallet that pays owns the namespace. No signup, no API keys. Exact-key storage for structured state. For retrieval by MEANING rather than key, use the catalog slugs memory-remember and memory-recall (on MCP, through catalog.call with that slug).
| Parameter | Type | Description |
|---|---|---|
| key * | string | Key to write (max 256 chars) |
| owner | string | Optional 0x namespace to write into (requires a readwrite grant) |
| value | any | Any JSON value (max 64KB serialized) |
| delete | boolean | Set true to delete the key instead |
| requestId | string | Optional client id for this write; a retry with the same id returns the first answer |
| ttlSeconds | number | Optional: auto-expire the key after N seconds |
{
"name": "memory.write",
"title": "Memory write",
"description": "Paid ($0.001/call): Persistent key-value memory for agents, scoped to the paying wallet. Your x402 payment IS your authentication: the wallet that pays owns the namespace. No signup, no API keys. Exact-key storage for structured state. For retrieval by MEANING rather than key, use the catalog slugs memory-remember and memory-recall (on MCP, through catalog.call with that slug).",
"inputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "Key to write (max 256 chars)"
},
"owner": {
"type": "string",
"description": "Optional 0x namespace to write into (requires a readwrite grant)"
},
"value": {
"description": "Any JSON value (max 64KB serialized)"
},
"delete": {
"type": "boolean",
"description": "Set true to delete the key instead"
},
"requestId": {
"type": "string",
"description": "Optional client id for this write; a retry with the same id returns the first answer"
},
"ttlSeconds": {
"type": "number",
"description": "Optional: auto-expire the key after N seconds"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"key"
],
"properties": {
"key": {
"type": "string"
},
"bytes": {
"type": "integer"
},
"owner": {
"type": "string"
},
"deleted": {
"type": "boolean"
},
"updated": {
"type": "number"
},
"expiresAt": {
"type": [
"number",
"null"
],
"description": "Expiry in unix seconds; null when the key does not expire"
},
"persistent": {
"type": "boolean"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Memory write",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}Paid ($0.010/call): Describe a job and get a call-ready plan: which tools, across this catalog and outside x402 sellers with a recently verified 402, solve it end to end, in what order, with fallbacks and input params that validate against each tool's schema.
| Parameter | Type | Description |
|---|---|---|
| task * | string | What the agent needs done (max 2000 chars) |
| depth | string | quick | plan (default) | full |
| constraints | object | maxBudgetUsd, maxLatencyMs, rails [x402|mpp], chains [CAIP-2 or namespace], excludeSellers [host], requireDeterministic |
{
"name": "decide.plan",
"title": "Decide: tool plan for a task",
"description": "Paid ($0.010/call): Describe a job and get a call-ready plan: which tools, across this catalog and outside x402 sellers with a recently verified 402, solve it end to end, in what order, with fallbacks and input params that validate against each tool's schema.",
"inputSchema": {
"type": "object",
"required": [
"task"
],
"properties": {
"task": {
"type": "string",
"description": "What the agent needs done (max 2000 chars)"
},
"depth": {
"enum": [
"quick",
"plan",
"full"
],
"type": "string",
"description": "quick | plan (default) | full"
},
"constraints": {
"type": "object",
"description": "maxBudgetUsd, maxLatencyMs, rails [x402|mpp], chains [CAIP-2 or namespace], excludeSellers [host], requireDeterministic"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"gaps": {
"type": "array"
},
"plan": {
"type": "array",
"items": {
"type": "object"
}
},
"task": {
"type": "string"
},
"depth": {
"type": "string"
},
"priceUsd": {
"type": "number"
},
"confidence": {
"type": "number"
},
"decisionId": {
"type": "string"
},
"feedbackToken": {
"type": "string"
},
"executionCredit": {
"type": "object",
"additionalProperties": true
},
"estimatedCostUsd": {
"type": "number"
},
"estimatedLatencyMs": {
"type": "number"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Decide: tool plan for a task",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Paid ($0.001/call): Run a decision's plan (decisionId from POST /api/decide), or a free plan sketch (steps), through Agent402: first-party steps run directly, third-party steps are bought from the seller and resold to you at Agent402's price (paid with a wallet on Base; prepaid credits and cards do not pay this route).
| Parameter | Type | Description |
|---|---|---|
| steps | array | Instead of decisionId: the tool slugs of a free plan sketch (from /api/find or /api/route), 2 to 5, in order. Pass params for step 1; a later step takes its one required input from the step before. |
| params | object | Per-step params overriding the plan's exampleParams, keyed by step number |
| replan | boolean | With decisionId: plan the saved task again on current prices and reliability, then run the new plan. Adds the plan price for that decision's depth to the quote; the answer's replanned field lists what changed. Default false. |
| decisionId | string | From POST /api/decide (or pass steps instead) |
| creditToken | string | executionCredit.token from that decision (optional) |
| maxBudgetUsd | number | Spend ceiling for the run (default: the plan's estimate via Agent402) |
{
"name": "decide.execute",
"title": "Decide: execute a plan",
"description": "Paid ($0.001/call): Run a decision's plan (decisionId from POST /api/decide), or a free plan sketch (steps), through Agent402: first-party steps run directly, third-party steps are bought from the seller and resold to you at Agent402's price (paid with a wallet on Base; prepaid credits and cards do not pay this route).",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"steps": {
"type": "array",
"items": {
"type": "string"
},
"description": "Instead of decisionId: the tool slugs of a free plan sketch (from /api/find or /api/route), 2 to 5, in order. Pass params for step 1; a later step takes its one required input from the step before."
},
"params": {
"type": "object",
"description": "Per-step params overriding the plan's exampleParams, keyed by step number"
},
"replan": {
"type": "boolean",
"description": "With decisionId: plan the saved task again on current prices and reliability, then run the new plan. Adds the plan price for that decision's depth to the quote; the answer's replanned field lists what changed. Default false."
},
"decisionId": {
"type": "string",
"description": "From POST /api/decide (or pass steps instead)"
},
"creditToken": {
"type": "string",
"description": "executionCredit.token from that decision (optional)"
},
"maxBudgetUsd": {
"type": "number",
"description": "Spend ceiling for the run (default: the plan's estimate via Agent402)"
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"runId": {
"type": "string"
},
"steps": {
"type": "array",
"items": {
"type": "object"
}
},
"status": {
"type": "string"
},
"paidUsd": {
"type": "number"
},
"spentUsd": {
"type": "number"
},
"budgetUsd": {
"type": "number"
},
"decisionId": {
"type": "string"
},
"routingFeePct": {
"type": "number"
},
"leftoverCredit": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
]
},
"creditAppliedUsd": {
"type": "number"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Decide: execute a plan",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}[free] Report a capability the 500+ tools do not cover, after catalog.search or catalog.find found nothing that fits. Requests are clustered by need, and frequent ones get built. Records demand only: it runs nothing. Same intake as POST https://agent402.tools/api/wish; aggregate demand is public at https://agent402.tools/api/wishes.
| Parameter | Type | Description |
|---|---|---|
| need * | string | What you needed and could not find, in plain language, e.g. "convert a HEIC image to JPEG" or "look up a UK company by registration number" |
| context | string | Optional: what you were trying to accomplish, or the input you had - helps disambiguate similar-sounding requests. |
{
"name": "demand.request",
"title": "Request a tool Agent402 does not have",
"description": "[free] Report a capability the 500+ tools do not cover, after catalog.search or catalog.find found nothing that fits. Requests are clustered by need, and frequent ones get built. Records demand only: it runs nothing. Same intake as POST https://agent402.tools/api/wish; aggregate demand is public at https://agent402.tools/api/wishes.",
"inputSchema": {
"type": "object",
"required": [
"need"
],
"properties": {
"need": {
"type": "string",
"maxLength": 500,
"description": "What you needed and could not find, in plain language, e.g. \"convert a HEIC image to JPEG\" or \"look up a UK company by registration number\""
},
"context": {
"type": "string",
"maxLength": 300,
"description": "Optional: what you were trying to accomplish, or the input you had - helps disambiguate similar-sounding requests."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"ok": {
"type": "boolean"
},
"need": {
"type": "string"
},
"message": {
"type": "string"
},
"clustered": {
"type": "boolean"
}
},
"additionalProperties": true
},
"annotations": {
"title": "Request a tool Agent402 does not have",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}[free] Describe this connector: the tools it lists, how to install (Claude Code / Cursor / npm), free vs paid tiers, and discovery URLs.
No parameters.
{
"name": "server.describe",
"title": "About this Agent402 connector",
"description": "[free] Describe this connector: the tools it lists, how to install (Claude Code / Cursor / npm), free vs paid tiers, and discovery URLs.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"required": [
"service",
"maintainer",
"startHere"
],
"properties": {
"docs": {
"type": "string"
},
"tools": {
"type": "integer"
},
"install": {
"type": "object",
"additionalProperties": true
},
"service": {
"type": "string"
},
"freeHere": {
"type": "integer"
},
"connector": {
"type": "string"
},
"ecosystem": {
"type": "string"
},
"frontDoor": {
"type": "object",
"properties": {
"use": {
"type": "string"
},
"guide": {
"type": "string"
},
"access": {
"type": "string"
},
"firstCall": {
"type": "string"
}
},
"additionalProperties": true
},
"rateLimit": {
"type": "string"
},
"startHere": {
"type": "object",
"additionalProperties": true
},
"workflows": {
"type": "object",
"additionalProperties": true
},
"maintainer": {
"type": "string"
},
"paidAccess": {
"type": "string"
},
"walletOnly": {
"type": "integer"
},
"missingATool": {
"type": "string"
},
"toolsEvergreen": {
"type": "string"
},
"clientsSeenSinceBoot": {
"type": "object",
"additionalProperties": true
}
},
"additionalProperties": true
},
"annotations": {
"title": "About this Agent402 connector",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}[free] Report whether one step of a decide.plan decision worked (success or failure, optional 1-5 quality and latency). Needs the decisionId and feedbackToken that decide.plan returned; one verdict per step, a later report replaces it. Reports feed tool reliability in future rankings.
| Parameter | Type | Description |
|---|---|---|
| step * | integer | |
| toolId | string | Optional: a fallback you used instead of the step's primary tool |
| outcome * | string | one of ["success","failure"] |
| quality | integer | |
| latencyMs | integer | |
| decisionId * | string | |
| feedbackToken * | string |
{
"name": "decide.feedback",
"title": "Report how a decide plan step went",
"description": "[free] Report whether one step of a decide.plan decision worked (success or failure, optional 1-5 quality and latency). Needs the decisionId and feedbackToken that decide.plan returned; one verdict per step, a later report replaces it. Reports feed tool reliability in future rankings.",
"inputSchema": {
"type": "object",
"required": [
"decisionId",
"feedbackToken",
"step",
"outcome"
],
"properties": {
"step": {
"type": "integer",
"minimum": 1
},
"toolId": {
"type": "string",
"description": "Optional: a fallback you used instead of the step's primary tool"
},
"outcome": {
"enum": [
"success",
"failure"
],
"type": "string"
},
"quality": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"latencyMs": {
"type": "integer",
"minimum": 0
},
"decisionId": {
"type": "string"
},
"feedbackToken": {
"type": "string"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"step": {
"type": "integer"
},
"toolId": {
"type": "string"
},
"outcome": {
"type": "string"
},
"replaced": {
"type": "boolean"
},
"decisionId": {
"type": "string"
}
}
},
"annotations": {
"title": "Report how a decide plan step went",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Agent402 is the payment and trust layer for agent commerce: agents find, pay for and verify every paid call to Agent402, across x402 and MPP, with a signed receipt for each one. 500+ ready tools on the same rails. Per-call tools and metered models, paid in USDC, or free through proof-of-work for the pure-CPU tools; the applied layer of Agentic Finance. Flagship tools: web.search (live web search), web.answer (answers with citations), web.news, browser.render, audio.transcribe, memory.read, memory.write. Long tail: catalog.search lists tools by keyword, catalog.find returns the best match with its input schema and price, catalog.call runs a tool by slug. Multi-step jobs: decide.plan returns a call-ready plan (tools, order, fallbacks, inputs); decide.execute runs it. The plan fee is credited toward the run. Also: server.describe (connector details), payment.info (wallet and payment setup), demand.request (report a missing tool). Install (npm package, pinned): claude mcp add agent402 -s user -- npx -y agent402-mcp@0.14.1 Hosted connector (proof-of-work tools free; other tools paid in the call over x402 or MPP from a wallet): claude mcp add --transport http agent402 https://agent402.tools/mcp Cursor mcp.json: { "mcpServers": { "agent402": { "url": "https://agent402.tools/mcp" } } } Docs: https://agent402.tools/llms.txt · status https://agent402.tools/status
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.