Server definition
- Hash
- sha256:c5109efddb67f1d005592b8190ace55120e3ea93bc989ad3f8d55f7c685deaa7
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Free discovery of x402 pay-per-call endpoints from 402xAgent's weekly crawl. Returns up to 20 endpoints matching the words in q (URL or source list), each with the verified (quoted) price, network, last_checked, stale flag, verdict pay|skip|recheck with its reason, and a receipt. Skips are included by default; pass verdict to filter. A result older than 36 h is stale; a pay whose terms are older than 7 days (TERMS_MAX_AGE_HOURS) is returned as recheck (reason_code terms_stale). Run endpoint_spot_check right before paying (pass quote=<result receipt_id> to be told if the live terms moved). Read-only, no auth, 60 calls per minute.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Optional. 2-100 chars; space-separated words that must all appear, e.g. \"weather\" or \"crypto price\".",
"type": "string"
},
"verdict": {
"description": "Optional filter on the (freshness-adjusted) verdict.",
"enum": [
"pay",
"skip",
"recheck"
],
"type": "string"
}
},
"type": "object"
},
"name": "discover",
"outputSchema": null
},
{
"description": "Paid ($0.05 USDC on Base via x402, no free tier): the exact committed snapshots behind endpoint_spot_check's locked teasers: which payment terms changed in the last 30 days, when, from what to what, and the full hygiene checks. Pass the url and the commitment_ref from the free answer's locked_commitments; verify each revealed {snapshot, nonce} against its sha256 digest (docs: https://402xagent.com/docs#endpoint-report).",
"inputSchema": {
"properties": {
"commitment_ref": {
"description": "locked_commitments.ref from the free check, e.g. cm-0123456789abcdef",
"type": "string"
},
"include_current": {
"description": "also return today's stored data under current (not covered by the commitment)",
"type": "boolean"
},
"url": {
"description": "the endpoint URL you checked, e.g. https://api.402rates.com/v1/ping",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "endpoint_report",
"outputSchema": null
},
{
"description": "Decision-shaped 402xAgent check of a public URL (private, loopback and link-local addresses blocked on every redirect hop) for an x402 PAYMENT-REQUIRED / 402 challenge. Every answer has reason_code (stable code) and confidence (high|medium|low); rules: https://402xagent.com/rules.json. History: stable_for_days, last_changed, drift, days_observed, first_seen, last_checked. Free: verdict (pay|skip|recheck), a plain-words reason, payment_terms_sha256 (hash of the approved payment), and access. Paid: verdict, reason code, quoted/claimed price, pay_to, network, asset, and payment = the exact {network, asset, amount_atomic, amount_usd, pay_to} a router may sign (verdict pay only), plus access with the settlement tx. No 402 terms is skip/no_paywall (recheck/free_trial_active when the target sends x-free-trial headers); recheck only for timeouts, 5xx, network errors and (0.55.0) HTTP 429 (rate_limited), a 403 with a firewall/WAF challenge signature (waf_challenge) or a host that still does not resolve after one retry (dns_error); after 24 h (TRANSIENT_SKIP_AFTER_HOURS) of only those rechecks the endpoint falls back to skip (*_persistent); (0.56.0) recheck/timeout when the whole probe (redirects + body) exceeds PROBE_TIMEOUT_MS (default 8000 ms), and recheck/host_unstable while the per-host circuit breaker is open (3 failed probes of the host in 10 min -> 15 min pause; target not fetched, no free check used, never charged); (0.57.0) before a live pay (after the free check or payment is accepted) a second quick probe of the same target must read the same 402 terms (scheme, network, asset, payTo; amount within 1%): different terms are recheck/terms_unstable, a failed confirm probe is its own recheck (server_error, timeout, unreachable); same price and free check; a plain 403 stays skip/no_paywall; wrong or unsupported network, non-canonical USDC or a pay_to that differs from the listing is skip. The same normalized URL + method reuses one probe for 5 min, so consecutive calls agree. mode=dry-run: free dry run (nothing signed or paid, stored as a public receipt, no approval hash, 50/caller/day). Never pays the target (probe GET only). 5 free checks per client per UTC day (at most 25 per network) (client=vc-mcp), then $0.02 USDC a check on Base via x402. Unpaid after free quota: payment instructions. Forward PAYMENT-SIGNATURE for a paid check.",
"inputSchema": {
"properties": {
"claimed_price": {
"description": "optional claimed USD price to compare vs quoted",
"type": "number"
},
"method": {
"description": "optional: probe the target with POST (empty JSON body) for POST-only endpoints",
"enum": [
"GET",
"POST"
],
"type": "string"
},
"mode": {
"description": "optional: dry-run = free dry run: one unpaid probe, nothing signed or paid, always stored as a public receipt (check_type dry-run). Returns the free-tier shape with payment_terms_sha256 null (never an approval). 50 per caller (ref, else client, else IP) per UTC day. ref=dry-run-<caller> also sets it",
"enum": [
"live",
"dry-run"
],
"type": "string"
},
"network": {
"description": "optional: the CAIP-2 network you expect, e.g. eip155:8453",
"type": "string"
},
"pay_to": {
"description": "optional: the wallet you expect to pay (from your listing)",
"type": "string"
},
"quote": {
"description": "optional (0.54.0): the receipt id you were quoted (a discover/crawl id, 10 hex, or a live sc- id). If the live terms (price, pay_to, network, asset) differ from it, the answer is recheck/terms_changed_since_quote instead of pay",
"type": "string"
},
"ref": {
"description": "optional attribution tag stored on the receipt (dry-run-<caller> sets mode=dry-run)",
"type": "string"
},
"task": {
"description": "optional task label (ignored in decision output)",
"type": "string"
},
"url": {
"description": "public http(s) URL to probe",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "endpoint_spot_check",
"outputSchema": null
},
{
"description": "Buy and download the Overnight Chief of Staff Setup Pack ($9 USDC on Base via x402): 5 ready-to-paste bot prompts, an HTML morning-briefing template, and a PDF setup guide. Always paid — no free quota. Call without PAYMENT-SIGNATURE to receive payment requirements and the HTTP endpoint URL. Agents pay by retrying the HTTP endpoint (or this MCP call) with a PAYMENT-SIGNATURE header holding a signed USDC EIP-3009 authorization.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_overnight_cos_pack",
"outputSchema": null
},
{
"description": "Free: read a public 402xAgent receipt. Give id (sc-... from endpoint_spot_check's receipt_id, or a 10-hex crawl id) or url (latest live + crawl receipt for that URL). Receipts hold the listing URL, the live 402 terms, verdict, reason, reason_code, confidence, history summary, timestamp, and a status-badge embed snippet (badge.markdown / badge.html). Does not run a fresh check (use endpoint_spot_check for that).",
"inputSchema": {
"properties": {
"id": {
"description": "receipt id",
"type": "string"
},
"url": {
"description": "endpoint URL exactly as checked",
"type": "string"
}
},
"type": "object"
},
"name": "get_receipt",
"outputSchema": null
},
{
"description": "Fetch the complete catalog record for one known service id (e.g. from search_catalog or lookup results). Use search_catalog to find ids and lookup to rank services for a task; get_service has no per-call receipts, so for receipts with tx and Basescan links call lookup with endpoint=<id>. Read-only. No auth or API key; free, no quota (reads the same catalog snapshot as search_catalog). Returns the record as published: id, name, provider, category, description, endpoint, advertised_price (USD, atomic, asset, network), sample_request, tasks, quality_test (known-answer test, facts_only flag and reason), paid_receipts (count), latest (full last check incl. x402_challenge, error, raw_log_url), history_summary and page_url. Unknown or missing id: error \"no service with id ...\".",
"inputSchema": {
"properties": {
"id": {
"description": "Exact, case-sensitive catalog service id as returned by search_catalog or lookup, e.g. \"exa-search\", \"x402tap-weather\", \"onesource-erc20-balance\".",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_service",
"outputSchema": null
},
{
"description": "Rank x402 endpoints for a known task at or under a price: \"which endpoint should I pay for task X at <= $Y?\". Prefer it over search_catalog (keyword browsing, unranked) and get_service (one id's raw record). No auth or API key. Calls the hosted lookup service as client=vc-mcp; all MCP users share that client's 5 free lookups per UTC day (reset 00:00 UTC), after which the tool returns an error reporting the HTTP 402 ($0.02 USDC on Base via x402) and never pays. Returns results sorted by known-answer pass_rate over the last n paid calls, then price, each with price_usd, pass_rate, last_check_at, last_check, stale and receipts (time, tx, basescan_url, charged_usd, delivered, quality); seller-broken services come unsorted under facts_only. No match: empty results, matched 0. Needs task or endpoint; invalid params return an error. Payment never changes results.",
"inputSchema": {
"properties": {
"endpoint": {
"description": "A catalog service id (e.g. exa-search) or endpoint URL, to get one service's receipts instead of a whole task. Required unless task is given; can be combined with task.",
"type": "string"
},
"limit": {
"default": 10,
"description": "Optional. Maximum ranked services in results, 1-20 (default 10; clamped). facts_only is not limited.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"max_price_usd": {
"description": "Optional. Only services whose listed price per call is at or below this many USD, e.g. 0.01. Negative values are rejected.",
"minimum": 0,
"type": "number"
},
"n": {
"default": 5,
"description": "Optional. Most recent paid receipts per service used for pass_rate and returned, 1-20 (default 5; out-of-range values are clamped).",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"payer": {
"description": "Optional 0x wallet address (40 hex characters), recorded so a later payment from it to a returned vendor can be matched on-chain. Nothing is charged; a malformed address returns an error.",
"type": "string"
},
"task": {
"description": "Task name from /v1/tasks, e.g. web-search, crypto-news, news, weather, token-balance, sec-filings, fx-rates, url-check. Case-insensitive; a known name matches exactly, an unknown one falls back to matching every word in service text. Required unless endpoint is given.",
"type": "string"
}
},
"type": "object"
},
"name": "lookup",
"outputSchema": null
},
{
"description": "Fetch one public web page and return clean, LLM-ready Markdown of its main content (no nav, footers, ads or cookie banners; absolute links; tables kept) plus title, description, links, word_count and token_estimate. Respects robots.txt; skips login walls, paywalls and 401/403 pages (never charged). 3 free pages per day, then $0.002 USDC on Base via x402: retry with the PAYMENT-SIGNATURE header.",
"inputSchema": {
"properties": {
"format": {
"description": "markdown = url/title/markdown only; json (default) = all fields",
"enum": [
"markdown",
"json"
],
"type": "string"
},
"url": {
"description": "http(s) URL of a public page",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "page_to_markdown",
"outputSchema": null
},
{
"description": "After you pay an x402 endpoint (Base USDC, EIP-3009 exact): did the payment land, and is it safe to sign a new one? Give payment_payload (the base64 PAYMENT-SIGNATURE you sent), or tx_hash, or from + nonce (+ valid_before). Returns status landed|not_landed|pending|canceled|unknown, safe_to_retry_same_payload (always true: a nonce is single-use), safe_to_resign (true only when two independent RPC sources agree the nonce is unused AND validBefore has passed), tx details, terms match, a claim pointer and a signed receipt. Same 5 free per UTC day as endpoint_spot_check (client=vc-mcp), then $0.02 USDC on Base via x402 (forward PAYMENT-SIGNATURE).",
"inputSchema": {
"properties": {
"from": {
"type": "string"
},
"nonce": {
"type": "string"
},
"payment_payload": {
"description": "base64 PAYMENT-SIGNATURE / X-PAYMENT value of the payment you sent",
"type": "string"
},
"seller_url": {
"description": "the URL you paid",
"type": "string"
},
"tx_hash": {
"type": "string"
},
"valid_before": {
"description": "unix seconds (with from + nonce)",
"type": "string"
}
},
"type": "object"
},
"name": "payment_status",
"outputSchema": null
},
{
"description": "Extract the tables (CSV, JSON, Markdown) and per-page text from one PDF at a public URL. Digital PDFs ~97% cell accuracy; scanned pages (OCR) ~80%. Priced per page via x402 USDC on Base: $0.005/page with ocr=never, $0.015/page with ocr=auto. Charged only if every page succeeds. Max 20 pages per call. Retry with the PAYMENT-SIGNATURE header.",
"inputSchema": {
"properties": {
"ocr": {
"description": "never (default, digital PDFs) or auto (OCR scanned pages, 3x price)",
"enum": [
"never",
"auto"
],
"type": "string"
},
"pages": {
"description": "page range, e.g. 1-3,7 (default: all, max 20)",
"type": "string"
},
"url": {
"description": "http(s) URL of a PDF",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "pdf_tables",
"outputSchema": null
},
{
"description": "Browse or keyword-search the verified catalog of pay-per-call (x402) agent services. Use it when you don't know the task name or want to see what exists; use lookup to rank endpoints for a known task at a max price, and get_service for one id's full record. Read-only. No auth or API key; free, no quota or per-client limit: it only reads the catalog snapshot (bundled catalog.json in the local server, the published catalog.json on remote /mcp). Returns {count, results, generated_at, note, methodology_url}; results are in catalog order, ungraded, each with id, name, category, endpoint, advertised_price_usd, page_url and latest (checked_at, reachable, http_status, latency_ms, quoted_price_usd, price_matches_listing, charged_price_usd, delivered_valid, raw_log_url). No match: count 0, empty results. A non-numeric max_price_usd or limit returns an error.",
"inputSchema": {
"properties": {
"category": {
"description": "Optional. Case-insensitive substring of the service category, e.g. \"web search\", \"news\", \"on-chain data\", \"weather\", \"public records\", \"utility\".",
"type": "string"
},
"limit": {
"default": 20,
"description": "Optional. Maximum number of results, 1-100 (default 20).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"max_price_usd": {
"description": "Optional. Keep services whose advertised price per call is at or below this many USD, e.g. 0.01.",
"minimum": 0,
"type": "number"
},
"query": {
"description": "Optional. Space-separated words; every word must appear (case-insensitive) in the service id, name, category, description or provider. Omit to list all. Examples: \"search\", \"crypto news\".",
"type": "string"
},
"reachable_only": {
"default": false,
"description": "Optional (default false). If true, keep only services that were reachable in the latest check.",
"type": "boolean"
}
},
"type": "object"
},
"name": "search_catalog",
"outputSchema": null
},
{
"description": "Free x402 hygiene score for an endpoint you run: {score, grade, deductions[{code, points, fix}]} from normal unpaid requests (never pays, never sends bad params). 20 per day per network, cached 24 h. Grades are returned only to you.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"url": {
"description": "Full http(s) URL of the x402 endpoint.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"name": "x402_hygiene",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c5109efddb67f1d005592b8190ace55120e3ea93bc989ad3f8d55f7c685deaa7 | sha256sum