Server definition
- Hash
- sha256:7416e89d7570a55ddacd841e956d4d11cabf4a0590ea5dbf9ac3fe6c598e8c28
- What it is
- What a remote MCP server returned when asked what it offers: 23 tools
The blob, as servednamed by its sha256
{
"instructions": "Directory of x402-paid + MCP services on agent-tools.cloud. Built for AGENT consumers — humans use the website, agents use these tools.\n\nTypical flow:\n 1. `ask_services(intent=...)` for an LLM-ranked recommendation, or\n `search(intent=..., has_mcp=True)` to manually inspect candidates.\n 2. Inspect `match_reason` + `confidence` + `tx_30d` on each item to\n judge quality. Prefer `popular+healthy` items.\n 3. `get(slug)` to fetch the service card: payment, call, quality,\n resource samples, and ready-to-paste MCP/x402 call hints.\n 4. Use `list_categories` to discover the taxonomy and `stats` for\n directory size + health.\n 5. `scan_mcp_safety(endpoint_url)` screens an MCP server for malware /\n prompt-injection lures: returns our latest stored verdict if it is\n already indexed, otherwise probes + scans it live and adds it to the\n directory.\n 6. `prepare_paid_verification` -> sign `typed_data` in your wallet ->\n `execute_paid_verification`: pay a service once and record the\n result. Needs an API key (`create_api_key` or POST /api/v1/keys).\n 7. With an account API key in the Authorization: Bearer header, use `claim_service_url(url)` -> publish the returned token -> `verify_service_url(claim_id, token)` -> `get_owned_listing` / `edit_owned_listing`. A claim covers only its exact public HTTPS URL, not the host or sibling services.",
"tools": [
{
"description": "Ask for the best x402/MCP services for an agent intent.\n\n This is the high-level discovery tool: it retrieves candidates from the\n directory, asks the configured backend LLM to rank only those candidates,\n and returns service cards for the selected recommendations. If the LLM is\n unavailable, it falls back to the directory ranker.\n\n Args:\n intent: Natural-language job the agent wants to accomplish.\n top_k: Max recommendations to return (1-10).\n max_price_usd: Optional per-call budget cap.\n category: Optional directory category filter.\n chain: Optional payment network filter, e.g. \"base\" or \"solana\".\n require_healthy: When true, only consider services marked health=ok.\n min_confidence: Optional x402scan quality floor (0.0-1.0).\n has_mcp: When true, only consider services with MCP endpoints.\n use_llm: Set false for deterministic retrieval-only fallback.\n ",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional directory category filter.",
"title": "Category"
},
"chain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional payment network filter, e.g. \"base\" or \"solana\".",
"title": "Chain"
},
"has_mcp": {
"default": false,
"description": "When true, only consider services with MCP endpoints.",
"title": "Has Mcp",
"type": "boolean"
},
"intent": {
"description": "Natural-language job the agent wants to accomplish.",
"title": "Intent",
"type": "string"
},
"max_price_usd": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional per-call budget cap.",
"title": "Max Price Usd"
},
"min_confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional x402scan quality floor (0.0-1.0).",
"title": "Min Confidence"
},
"require_healthy": {
"default": true,
"description": "When true, only consider services marked health=ok.",
"title": "Require Healthy",
"type": "boolean"
},
"top_k": {
"default": 5,
"description": "Max recommendations to return (1-10).",
"title": "Top K",
"type": "integer"
},
"use_llm": {
"default": true,
"description": "Set false for deterministic retrieval-only fallback.",
"title": "Use Llm",
"type": "boolean"
}
},
"required": [
"intent"
],
"title": "ask_servicesArguments",
"type": "object"
},
"name": "ask_services",
"outputSchema": {
"additionalProperties": true,
"title": "ask_servicesDictOutput",
"type": "object"
}
},
{
"description": "Issue a fresh ownership token for one exact public HTTPS URL.\n\n Authenticate in the MCP Authorization: Bearer header. Publishing and\n verifying the token is required before editing; URL input alone grants no rights.\n\n Args:\n url: Complete public HTTPS service URL, including its query when present.\n method: Optional proof method; otherwise inferred from the complete URL.\n ",
"inputSchema": {
"properties": {
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional proof method; otherwise inferred from the complete URL.",
"title": "Method"
},
"url": {
"description": "Complete public HTTPS service URL, including its query when present.",
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "claim_service_urlArguments",
"type": "object"
},
"name": "claim_service_url",
"outputSchema": {
"additionalProperties": true,
"title": "claim_service_urlDictOutput",
"type": "object"
}
},
{
"description": "Create a free account API key. No sign-up, email or existing key needed.\n\n The key is returned once and cannot be recovered. Store it in your secret\n store; do not print it back to the user or write it to logs. Send it as\n `Authorization: Bearer <key>` (or the `api_key` argument where offered) to\n get complete `directory_stats` lists, run paid verifications and claim\n your own listings. The claim and listing tools read the key only from the\n Authorization header; without header support use the REST claim API. Shares the HTTP limit of POST /api/v1/keys (a few keys\n per IP per day).\n\n Args:\n name: Optional label to recognise the key later, e.g. your agent name.\n ",
"inputSchema": {
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional label to recognise the key later, e.g. your agent name.",
"title": "Name"
}
},
"title": "create_api_keyArguments",
"type": "object"
},
"name": "create_api_key",
"outputSchema": {
"additionalProperties": true,
"title": "create_api_keyDictOutput",
"type": "object"
}
},
{
"description": "Daily statistics on the agent-tool ecosystem as seen by our probes.\n\n Args:\n view: \"all\", \"mcp\", \"x402\" or \"a2a\" to scope the figures to one protocol.\n topic: Optional topic word (e.g. \"payment\", \"weather\") to get that topic\n instead: supply per protocol, readiness, best listings, searches.\n month: Optional \"YYYY-MM\" to get that monthly report instead.\n api_key: Optional account key (free from create_api_key) for complete\n lists when you cannot send the Authorization header.\n\n Returns counts (indexed, reachable, protocol-verified, readiness A/B), one\n finding sentence per topic, key facts (x402 prices and networks, MCP and A2A\n protocol versions, MCP auth, A2A card signatures, how every listing's\n latest probe ended), the most searched terms (view \"all\"), the snapshot\n time, and links to the full JSON snapshot, the daily CSV, the methodology,\n the \"how many work\" page, per-protocol and per-topic pages and the monthly\n reports. With an account API key (Authorization: Bearer header or\n `api_key`; free from `create_api_key`) the topic and search lists are\n complete (10 listings per protocol, up to 100 terms); without one they\n are shortened.\n ",
"inputSchema": {
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional account key (free from create_api_key) for complete lists when you cannot send the Authorization header.",
"title": "Api Key"
},
"month": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional \"YYYY-MM\" to get that monthly report instead.",
"title": "Month"
},
"topic": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional topic word (e.g. \"payment\", \"weather\") to get that topic instead: supply per protocol, readiness, best listings, searches.",
"title": "Topic"
},
"view": {
"default": "all",
"description": "\"all\", \"mcp\", \"x402\" or \"a2a\" to scope the figures to one protocol.",
"title": "View",
"type": "string"
}
},
"title": "directory_statsArguments",
"type": "object"
},
"name": "directory_stats",
"outputSchema": {
"additionalProperties": true,
"title": "directory_statsDictOutput",
"type": "object"
}
},
{
"description": "Edit only metadata covered by your verified claim, with the public audit trail.\n\n An endpoint change requires verified control of the exact destination or\n its whole host and clears measurements tied to the old primary endpoint.\n\n Args:\n kind: Listing type: x402, mcp, or a2a.\n slug: Slug of the listing you are authorized to edit.\n fields: Editable fields to change; measured fields are rejected.\n ",
"inputSchema": {
"properties": {
"fields": {
"additionalProperties": true,
"description": "Editable fields to change; measured fields are rejected.",
"title": "Fields",
"type": "object"
},
"kind": {
"description": "Listing type: x402, mcp, or a2a.",
"title": "Kind",
"type": "string"
},
"slug": {
"description": "Slug of the listing you are authorized to edit.",
"title": "Slug",
"type": "string"
}
},
"required": [
"kind",
"slug",
"fields"
],
"title": "edit_owned_listingArguments",
"type": "object"
},
"name": "edit_owned_listing",
"outputSchema": {
"additionalProperties": true,
"title": "edit_owned_listingDictOutput",
"type": "object"
}
},
{
"description": "Send the signed payment to the service once and score the result.\n\n Aborts without paying if price or recipient changed. Never retried; a\n timeout returns `indeterminate`. status: succeeded | delivery_failed |\n payment_rejected | indeterminate.\n\n Args:\n id: `id` returned by `prepare_paid_verification`.\n signature: 0x EIP-712 signature of its `typed_data` by the payer.\n api_key: Optional if the Authorization header is sent.\n ",
"inputSchema": {
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional if the Authorization header is sent.",
"title": "Api Key"
},
"id": {
"description": "`id` returned by `prepare_paid_verification`.",
"title": "Id",
"type": "string"
},
"signature": {
"description": "0x EIP-712 signature of its `typed_data` by the payer.",
"title": "Signature",
"type": "string"
}
},
"required": [
"id",
"signature"
],
"title": "execute_paid_verificationArguments",
"type": "object"
},
"name": "execute_paid_verification",
"outputSchema": {
"additionalProperties": true,
"title": "execute_paid_verificationDictOutput",
"type": "object"
}
},
{
"description": "Get full details + ready-to-paste call template for a service.\n\n Returns the service card with payment, call, quality, resource samples,\n and ready-to-use MCP/x402 call hints. Use this after `search` or\n `ask_services` before paying/calling an external service.\n\n Args:\n slug: Service slug as returned by `search` items.\n ",
"inputSchema": {
"properties": {
"slug": {
"description": "Service slug as returned by `search` items.",
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "getArguments",
"type": "object"
},
"name": "get",
"outputSchema": {
"additionalProperties": true,
"title": "getDictOutput",
"type": "object"
}
},
{
"description": "Read one published Blog article: metadata plus the full Markdown body.\n\n Args:\n slug: The article slug, as returned by list_articles.\n ",
"inputSchema": {
"properties": {
"slug": {
"description": "The article slug, as returned by list_articles.",
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_articleArguments",
"type": "object"
},
"name": "get_article",
"outputSchema": {
"additionalProperties": true,
"title": "get_articleDictOutput",
"type": "object"
}
},
{
"description": "Get the full card for one MCP server by slug.\n\n Args:\n slug: MCP server slug as returned by `search_mcp_servers` items.\n ",
"inputSchema": {
"properties": {
"slug": {
"description": "MCP server slug as returned by `search_mcp_servers` items.",
"title": "Slug",
"type": "string"
}
},
"required": [
"slug"
],
"title": "get_mcp_serverArguments",
"type": "object"
},
"name": "get_mcp_server",
"outputSchema": {
"additionalProperties": true,
"title": "get_mcp_serverDictOutput",
"type": "object"
}
},
{
"description": "How every score and statistic on agent-tools.cloud is computed.\n\n Returns the quality-score components and grade bands per protocol, the nine\n readiness criteria with weights, payment-evidence grades, the probing\n schedule and the definitions behind the daily statistics.\n ",
"inputSchema": {
"properties": {},
"title": "get_methodologyArguments",
"type": "object"
},
"name": "get_methodology",
"outputSchema": {
"additionalProperties": true,
"title": "get_methodologyDictOutput",
"type": "object"
}
},
{
"description": "Read editable metadata for a listing covered by your verified claim.\n\n Args:\n kind: Listing type: x402, mcp, or a2a.\n slug: Slug from the verified claim's listings or directory search.\n ",
"inputSchema": {
"properties": {
"kind": {
"description": "Listing type: x402, mcp, or a2a.",
"title": "Kind",
"type": "string"
},
"slug": {
"description": "Slug from the verified claim's listings or directory search.",
"title": "Slug",
"type": "string"
}
},
"required": [
"kind",
"slug"
],
"title": "get_owned_listingArguments",
"type": "object"
},
"name": "get_owned_listing",
"outputSchema": {
"additionalProperties": true,
"title": "get_owned_listingDictOutput",
"type": "object"
}
},
{
"description": "Read one of your own paid verifications.\n\n Args:\n id: Verification id.\n api_key: Optional if the Authorization header is sent.\n ",
"inputSchema": {
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional if the Authorization header is sent.",
"title": "Api Key"
},
"id": {
"description": "Verification id.",
"title": "Id",
"type": "string"
}
},
"required": [
"id"
],
"title": "get_paid_verificationArguments",
"type": "object"
},
"name": "get_paid_verification",
"outputSchema": {
"additionalProperties": true,
"title": "get_paid_verificationDictOutput",
"type": "object"
}
},
{
"description": "List published Blog articles, newest first (metadata only).\n\n Args:\n query: Optional words to match in title, summary or body.\n tag: Optional tag to filter by.\n page: Page number, 20 articles per page.\n\n Use get_article(slug) for the full Markdown body.\n ",
"inputSchema": {
"properties": {
"page": {
"default": 1,
"description": "Page number, 20 articles per page.",
"title": "Page",
"type": "integer"
},
"query": {
"default": "",
"description": "Optional words to match in title, summary or body.",
"title": "Query",
"type": "string"
},
"tag": {
"default": "",
"description": "Optional tag to filter by.",
"title": "Tag",
"type": "string"
}
},
"title": "list_articlesArguments",
"type": "object"
},
"name": "list_articles",
"outputSchema": {
"additionalProperties": true,
"title": "list_articlesDictOutput",
"type": "object"
}
},
{
"description": "List all available service categories in the directory.",
"inputSchema": {
"properties": {},
"title": "list_categoriesArguments",
"type": "object"
},
"name": "list_categories",
"outputSchema": {
"additionalProperties": true,
"title": "list_categoriesDictOutput",
"type": "object"
}
},
{
"description": "Quote a sponsored paid verification of an x402 service.\n\n You pay the service once from your own wallet (Base USDC, <= $1; funds go\n to its payTo). Sign the returned `typed_data` (EIP-712), then call\n `execute_paid_verification` before `valid_before`. We never sign or hold funds.\n\n Auth: API key from POST https://agent-tools.cloud/api/v1/keys, as the\n `Authorization: Bearer` header or `api_key`.\n\n Args:\n slug: Service slug from `search` / `get`.\n payer: 0x address of the wallet that will sign and pay.\n api_key: Optional if the Authorization header is sent.\n\n Returns:\n { id, amount_usd, pay_to, valid_before, typed_data, ... } or { error, message }.\n ",
"inputSchema": {
"properties": {
"api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional if the Authorization header is sent.",
"title": "Api Key"
},
"payer": {
"description": "0x address of the wallet that will sign and pay.",
"title": "Payer",
"type": "string"
},
"slug": {
"description": "Service slug from `search` / `get`.",
"title": "Slug",
"type": "string"
}
},
"required": [
"slug",
"payer"
],
"title": "prepare_paid_verificationArguments",
"type": "object"
},
"name": "prepare_paid_verification",
"outputSchema": {
"additionalProperties": true,
"title": "prepare_paid_verificationDictOutput",
"type": "object"
}
},
{
"description": "Self-register an x402 / MCP service in the agent-tools directory.\n\n Service owners and agents may submit new services here. Submissions\n are auto-reviewed instantly by x402 verification (no human gate): if\n the URL proves x402 payment support it is listed immediately and shows\n up in `search`; otherwise it is rejected or retried automatically.\n Listing is FREE.\n\n Dedup: if a service with the same canonical origin (scheme://host)\n already exists in the directory we return its slug instead of\n creating a duplicate submission. Same goes for a still-pending\n submission with the same origin.\n\n Rate limit: at most 5 pending submissions per client IP per 24h.\n Hits beyond that get `{error: rate_limited}` — try again later or\n email [email protected] for bulk imports.\n\n Args:\n url: Public HTTPS URL of the service (the x402-payable endpoint\n or its homepage). Required.\n name: Human-friendly name. Defaults to the URL hostname.\n description: One-paragraph description (max ~2000 chars).\n mcp_url: If the service speaks MCP, its streamable-http endpoint.\n category: Free-form (e.g. \"defi\", \"search\", \"social\"). Use\n `list_categories` to align with existing taxonomy.\n chains: Networks the service accepts payment on\n (e.g. [\"base\", \"solana\"]).\n price_min_usdc: Lower bound of per-call price in USDC.\n price_max_usdc: Upper bound of per-call price in USDC.\n contact: Optional email / handle the directory team can reach\n you on for clarifications.\n ",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Free-form (e.g. \"defi\", \"search\", \"social\"). Use `list_categories` to align with existing taxonomy.",
"title": "Category"
},
"chains": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Networks the service accepts payment on (e.g. [\"base\", \"solana\"]).",
"title": "Chains"
},
"contact": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional email / handle the directory team can reach you on for clarifications.",
"title": "Contact"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One-paragraph description (max ~2000 chars).",
"title": "Description"
},
"mcp_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "If the service speaks MCP, its streamable-http endpoint.",
"title": "Mcp Url"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-friendly name. Defaults to the URL hostname.",
"title": "Name"
},
"price_max_usdc": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Upper bound of per-call price in USDC.",
"title": "Price Max Usdc"
},
"price_min_usdc": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Lower bound of per-call price in USDC.",
"title": "Price Min Usdc"
},
"url": {
"description": "Public HTTPS URL of the service (the x402-payable endpoint or its homepage). Required.",
"title": "Url",
"type": "string"
}
},
"required": [
"url"
],
"title": "registerArguments",
"type": "object"
},
"name": "register",
"outputSchema": {
"additionalProperties": true,
"title": "registerDictOutput",
"type": "object"
}
},
{
"description": "Check an MCP server for malware / prompt-injection lures by its endpoint URL.\n\n Give the server's streamable-http endpoint URL. Two paths:\n\n * **Already in the agent-tools directory** → returns our LATEST stored\n rule verdict. Every indexed server is re-scanned hourly, so you get a\n consistent, continuously-refreshed answer without re-probing.\n * **Not yet indexed** → we probe the endpoint live, statically scan its\n advertised tools + metadata, and return the fresh verdict. It is ADDED\n to the directory (so the next caller gets the stored verdict instantly)\n only if it answered or you supplied metadata; documentation hosts such\n as example.com / *.test / *.invalid are scanned but never listed.\n\n Two dimensions are reported. `verdict` is authoritative and comes from\n deterministic static rules — pure pattern-matching over the *advertised*\n text only, NO code execution. It flags the social-engineering / RCE tricks\n listing-spam servers use:\n\n * `curl … | bash` and `base64 -d | sh` install lures\n * `eval \"$(curl …)\"` / PowerShell `IEX(...DownloadString)` cradles\n * base64 blobs that decode to a shell command\n * bare-IP payload hosts and cheap throwaway TLDs\n * prompt-injection / credential-exfiltration phrasing\n (\"ignore previous instructions\", \"send your .env / api key\")\n * MCP tool-poisoning coercion — descriptions that hijack an agent's\n tool-calling (\"always call this tool first\", \"before using any other\n tool you must…\"), hidden `<IMPORTANT>` instructions, \"list all API\n keys / include secrets in your response\", and coercion to read &\n forward `.key`/`.pem`/`.ssh`/`.env` files\n\n Source-code-oriented rules (SQL / command / code injection) are deliberately\n not applied to natural-language descriptions, to avoid false positives.\n\n `llm_reference` is an advisory frontier-LLM second opinion over the same text.\n Because the LLM is slow it is computed LIVE on this call only and is never\n stored (the hourly job never runs it), so it may be null on timeout. It\n never overrides the rule verdict; when it is *more* severe than the rules an\n `advisory` note is attached as a safety-net signal. Security/defense\n products that merely *name* these attacks are not flagged.\n\n Args:\n endpoint_url: The MCP server's streamable-http URL (required). This is\n the identity we look up / index by.\n name: Optional advertised name (used when the server is new and gets\n added; falls back to the URL host).\n description: Optional description / README blurb (scanned when new).\n tools_text: Optional tool names + descriptions; used only if the live\n probe cannot fetch the server's tools/list.\n\n Returns:\n { verdict: \"clean\"|\"suspicious\"|\"malicious\", score: 0-100,\n reasons: [{rule, weight, snippet}],\n llm_reference: {model, verdict, reason, confidence} | null,\n advisory: str | null, slug, name, endpoint_url,\n source: \"stored\" (existing) | \"new_scan\" (just added), indexed: bool }\n ",
"inputSchema": {
"properties": {
"description": {
"default": "",
"description": "Optional description / README blurb (scanned when new).",
"title": "Description",
"type": "string"
},
"endpoint_url": {
"description": "The MCP server's streamable-http URL (required). This is the identity we look up / index by.",
"title": "Endpoint Url",
"type": "string"
},
"name": {
"default": "",
"description": "Optional advertised name (used when the server is new and gets added; falls back to the URL host).",
"title": "Name",
"type": "string"
},
"tools_text": {
"default": "",
"description": "Optional tool names + descriptions; used only if the live probe cannot fetch the server's tools/list.",
"title": "Tools Text",
"type": "string"
}
},
"required": [
"endpoint_url"
],
"title": "scan_mcp_safetyArguments",
"type": "object"
},
"name": "scan_mcp_safety",
"outputSchema": {
"additionalProperties": true,
"title": "scan_mcp_safetyDictOutput",
"type": "object"
}
},
{
"description": "Find x402 / MCP services matching an intent or filter set.\n\n Two usage modes (agents pick whichever fits):\n A. Natural-language: `search(intent=\"fetch tweets for @user\")`\n B. Pure browse: `search(has_mcp=True, category=\"defi\", top_k=10)`\n At least one of `intent`, `category`, `chain`, `has_mcp`,\n `min_confidence` must be supplied — otherwise the call is\n rejected (we won't dump 2300+ rows).\n\n Results are ranked by:\n (health=ok AND tx_30d>0) → health=ok → has-quality-signal →\n confidence → tx_30d → recency.\n So the highest-quality real-traffic services appear first.\n\n Each item includes (when available):\n - confidence : 0.0–1.0 x402scan quality score.\n - tx_30d : 30-day x402 payment count (proxy for real usage).\n - match_snippet : FTS snippet showing where `intent` hit ([[token]]).\n - match_reason : list[str] of human-readable ranking signals.\n - mcp_url : populated when the service exposes an MCP endpoint\n (you can call it directly via streamable-http).\n Agents should prefer items with non-null confidence and tx_30d > 0\n unless the user explicitly wants experimental endpoints.\n\n Args:\n intent: What the agent wants to do (English or Chinese). Optional\n when at least one structured filter is set. Synonym expansion\n covers twitter↔X↔推特, whale↔巨鲸, price↔价格 etc.\n top_k: Max services to return (default 5, hard cap 25).\n max_price_usd: Upper bound on per-call price in USD.\n category: Filter (see `list_categories`).\n chain: \"base\", \"polygon\", \"solana\", \"arbitrum\", ...\n min_confidence: Minimum confidence (0.0–1.0). 0.8+ keeps only\n services x402scan rates as high-quality.\n has_mcp: When true, return only services with a callable MCP\n endpoint. Use this when the agent wants to chain another MCP\n server rather than perform raw HTTP+x402.\n ",
"inputSchema": {
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter (see `list_categories`).",
"title": "Category"
},
"chain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "\"base\", \"polygon\", \"solana\", \"arbitrum\", ...",
"title": "Chain"
},
"has_mcp": {
"default": false,
"description": "When true, return only services with a callable MCP endpoint. Use this when the agent wants to chain another MCP server rather than perform raw HTTP+x402.",
"title": "Has Mcp",
"type": "boolean"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What the agent wants to do (English or Chinese). Optional when at least one structured filter is set. Synonym expansion covers twitter↔X↔推特, whale↔巨鲸, price↔价格 etc.",
"title": "Intent"
},
"max_price_usd": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Upper bound on per-call price in USD.",
"title": "Max Price Usd"
},
"min_confidence": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum confidence (0.0–1.0). 0.8+ keeps only services x402scan rates as high-quality.",
"title": "Min Confidence"
},
"top_k": {
"default": 5,
"description": "Max services to return (default 5, hard cap 25).",
"title": "Top K",
"type": "integer"
}
},
"title": "searchArguments",
"type": "object"
},
"name": "search",
"outputSchema": {
"additionalProperties": true,
"title": "searchDictOutput",
"type": "object"
}
},
{
"description": "Find A2A agents you can delegate a task to.\n\n Args:\n intent: Natural-language description of the task to delegate.\n top_k: Max agents to return (1-20).\n x402_only: When true, only return agents that advertise x402 payment.\n ",
"inputSchema": {
"properties": {
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Natural-language description of the task to delegate.",
"title": "Intent"
},
"top_k": {
"default": 5,
"description": "Max agents to return (1-20).",
"title": "Top K",
"type": "integer"
},
"x402_only": {
"default": false,
"description": "When true, only return agents that advertise x402 payment.",
"title": "X402 Only",
"type": "boolean"
}
},
"title": "search_a2a_agentsArguments",
"type": "object"
},
"name": "search_a2a_agents",
"outputSchema": {
"additionalProperties": true,
"title": "search_a2a_agentsDictOutput",
"type": "object"
}
},
{
"description": "Find MCP servers in the directory.\n\n Searches the standalone MCP directory (official MCP Registry, Smithery,\n Agenstry and other crawled sources) unioned with x402 services that also\n expose an MCP endpoint.\n Returns normalised entries with a ready-to-use streamable-http\n `call_hint.mcp.url`.\n\n Args:\n intent: Natural-language description of the tool/capability needed.\n top_k: Max servers to return (1-20).\n chain: Optional payment-network filter for paid MCP servers.\n require_healthy: When true, only return servers marked health=ok.\n scope: \"remote\" (default) = servers with an endpoint you can call now;\n \"code\" = code-only servers (repository / package you install and\n run yourself, no remote endpoint); \"all\" = both.\n ",
"inputSchema": {
"properties": {
"chain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional payment-network filter for paid MCP servers.",
"title": "Chain"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Natural-language description of the tool/capability needed.",
"title": "Intent"
},
"require_healthy": {
"default": false,
"description": "When true, only return servers marked health=ok.",
"title": "Require Healthy",
"type": "boolean"
},
"scope": {
"default": "remote",
"description": "\"remote\" (default) = servers with an endpoint you can call now; \"code\" = code-only servers (repository / package you install and run yourself, no remote endpoint); \"all\" = both.",
"title": "Scope",
"type": "string"
},
"top_k": {
"default": 5,
"description": "Max servers to return (1-20).",
"title": "Top K",
"type": "integer"
}
},
"title": "search_mcp_serversArguments",
"type": "object"
},
"name": "search_mcp_servers",
"outputSchema": {
"additionalProperties": true,
"title": "search_mcp_serversDictOutput",
"type": "object"
}
},
{
"description": "Unified search across x402 services, MCP servers and A2A agents.\n\n Args:\n intent: Natural-language query.\n protocol: Optional filter: \"x402\", \"mcp\" or \"a2a\".\n top_k: Max resources to return (1-50).\n ",
"inputSchema": {
"properties": {
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Natural-language query.",
"title": "Intent"
},
"protocol": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional filter: \"x402\", \"mcp\" or \"a2a\".",
"title": "Protocol"
},
"top_k": {
"default": 10,
"description": "Max resources to return (1-50).",
"title": "Top K",
"type": "integer"
}
},
"title": "search_resourcesArguments",
"type": "object"
},
"name": "search_resources",
"outputSchema": {
"additionalProperties": true,
"title": "search_resourcesDictOutput",
"type": "object"
}
},
{
"description": "High-level stats about the directory: x402 total, healthy count and chains,\n plus `snapshot`, the daily digest across x402, MCP and A2A (see directory_stats).",
"inputSchema": {
"properties": {},
"title": "statsArguments",
"type": "object"
},
"name": "stats",
"outputSchema": {
"additionalProperties": true,
"title": "statsDictOutput",
"type": "object"
}
},
{
"description": "Verify public ownership proof for your own exact service URL claim.\n\n This reads public proof only. It never calls business tools, requests\n private service credentials, or grants whole-platform permissions.\n\n Args:\n claim_id: Claim id returned by claim_service_url.\n token: The issued token after publishing it in the instructed location.\n ",
"inputSchema": {
"properties": {
"claim_id": {
"description": "Claim id returned by claim_service_url.",
"title": "Claim Id",
"type": "integer"
},
"token": {
"description": "The issued token after publishing it in the instructed location.",
"title": "Token",
"type": "string"
}
},
"required": [
"claim_id",
"token"
],
"title": "verify_service_urlArguments",
"type": "object"
},
"name": "verify_service_url",
"outputSchema": {
"additionalProperties": true,
"title": "verify_service_urlDictOutput",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:7416e89d7570a55ddacd841e956d4d11cabf4a0590ea5dbf9ac3fe6c598e8c28 | sha256sum