Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,160Letters: 84Defects: 3,898counted 2 min ago
teppi

Server definition

Hash
sha256:bb89a7aa3b670a735197605db338f5cf902e5455c1ab8c3508790ed5a21e594a
What it is
What a remote MCP server returned when asked what it offers: 6 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Simple direct way to buy a digital gift card (Amazon, Steam, Apple, Netflix, Google Play, PlayStation, Xbox, IKEA, Airbnb, …) via natural language. Describe what you want in `prompt`, e.g. \"steam 25 USD\" or \"amazon 50 euro germany\". If country is omitted, US is used as default. Minimal card nominal is $1. The product and denomination are matched automatically: the closest package for the requested value is selected. Note: the card nominal is not the final charge - expect a deviation. The exact amount is shown in the 402 `accepts` - compare it against your request before signing. Flow: if you have a balance (see `top_up_balance`) and it covers the price, pass `buyerID` next to `prompt` - payment is taken from balance, no 402 challenge, so it is much faster. Otherwise the first call WITHOUT a payment signature returns isError=true with `x402Version` + `accepts` in structuredContent (the price is computed dynamically from the product and denomination you asked for). Sign those accepts and retry with `_meta[\"x402/payment\"]` (base64 payload). On success returns the redemption code(s) under `structuredContent.redemption`, or `structuredContent.delivery=\"pending\"` if not delivered yet - codes then appear later in `get_my_history` under `orders[\"gift-cards\"][productKey]` (string for one code, array for several). If the product cannot be resolved or fails after you paid, the call is refunded automatically (structuredContent.refunded=true). Limits per IP: 12 free probes/h, then paid calls 300/5min. Tip: see the `top_up_balance` tool description to learn how to speed up processing of your calls via balance.", "inputSchema": { "additionalProperties": false, "properties": { "buyerID": { "description": "Optional 16-char buyer ID (meta.yourID from any paid response). Pass it in the first call (next to `prompt`) to skip the 402 challenge: if the balance covers the price, payment is taken from balance (no on-chain signature, so it will be much faster). If the balance is partial, you still get 402 for the shortfall - sign and retry with _meta[\"x402/payment\"].", "maxLength": 16, "minLength": 16, "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" }, "prompt": { "description": "Natural-language purchase intent. Include brand, denomination, and optionally country.", "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "prompt" ], "type": "object" }, "name": "buy_gift_cards", "outputSchema": { "properties": { "accepts": { "type": "array" }, "country": { "type": "string" }, "delivery": { "enum": [ "delivered", "pending" ], "type": "string" }, "error": { "type": "string" }, "meta": { "description": "Response metadata. Present in both success and error responses.", "properties": { "contacts": { "description": "Support contact, e.g. \"[email protected]\".", "format": "email", "type": "string" }, "responseTimeMs": { "type": "integer" }, "timestamp": { "type": "string" }, "yourID": { "description": "16-char buyer ID assigned to the payer. Use it as `buyerID` in `get_my_history` to retrieve redemption codes once `delivery` becomes \"delivered\". Only present on success responses where the payer was identified, absent on pre-payment errors (400) and on refunded failures where the payer could not be resolved.", "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" } }, "required": [ "timestamp", "responseTimeMs", "contacts" ], "type": "object" }, "note": { "type": "string" }, "packageValue": { "type": "string" }, "product": { "type": "string" }, "productKey": { "type": "string" }, "redemption": { "items": { "properties": { "code": { "type": [ "string", "null" ] }, "extra_fields": {}, "instructions": { "type": [ "string", "null" ] }, "link": { "type": [ "string", "null" ] }, "orderId": {}, "pin": { "type": [ "string", "null" ] }, "product": {}, "status": { "type": "string" } }, "type": "object" }, "type": [ "array", "null" ] }, "refunded": { "type": "boolean" }, "requiredArgs": { "type": "array" }, "status": { "enum": [ "ok", "payment_required", "error" ], "type": "string" }, "success": { "type": "boolean" }, "x402Version": { "type": "integer" } }, "type": "object" } }, { "description": "Executes an endpoint found via search_endpoints. Pass `routeId` and `arguments` (keys = `parameters[].name` of that route, omit if the route has none). Flow: if you have a balance (see `top_up_balance`) and it covers the route price, pass `buyerID` next to `routeId` (not inside arguments - that object is forwarded to the endpoint) - payment is taken from balance, no 402 challenge, so it is much faster. Otherwise the first call WITHOUT a payment signature returns isError=true with `x402Version`+`accepts` in structuredContent - sign those accepts and retry with `_meta[\"x402/payment\"]` (base64 payload); a partial balance still yields a 402 for the shortfall. Other isError cases: `invalid_arguments` (structuredContent.details[]/requiredArgs[] tell what to fix and retry), `route_unresolved` (pick another routeId from plan[]), `failed` (refunded/refundTx; try another route). On success, returns the actual result of the endpoint. No auth. Limits (per IP): paid 300/5min, burst 200/10s, total 1000/15min. Tip: see the `top_up_balance` tool description to learn how to speed up processing of your calls via balance.", "inputSchema": { "properties": { "arguments": { "description": "Endpoint arguments. Keys = `parameters[].name` of the chosen route. Example: `parameters[] = [{name:\"address\", in:\"path\", required:true}]` → `{ \"address\": \"0x098B…\" }`.", "type": "object" }, "buyerID": { "description": "Optional 16-char buyer ID (meta.yourID from any paid response). Pass it in the first call next to `routeId` to skip the 402 challenge: if the balance covers the route price, payment is taken from balance (no on-chain signature, so it is much faster). If the balance is partial, you still get 402 for the shortfall - sign and retry with _meta[\"x402/payment\"]. ", "maxLength": 16, "minLength": 16, "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" }, "routeId": { "description": "Candidate `routeId` from search_endpoints `plan[].routes[].routeId`.", "type": "string" } }, "required": [ "routeId" ], "type": "object" }, "name": "call_endpoint", "outputSchema": null }, { "description": "Fast and simple way to get morning brief in one call: weather, S&P 500 / Dow / NASDAQ, BTC/ETH/SOL with 24h change, top-5 news. Use it when the user asks for a daily brief, morning digest, market+weather snapshot, or what is happening today. Do NOT use for single-fact lookups or for tickers/coins/countries outside the fixed set - use search_endpoints → call_endpoint instead. Free, read-only. Rate limit: 20 calls / 5 min per agent (key = x-agent-id, else ip:user-agent), exceeding → 429 + Retry-After as errors[].retryAfter.", "inputSchema": { "additionalProperties": false, "properties": { "newsreg": { "description": "2-letter ISO country code for news. If omitted, defaults to worldwide headlines. Non-2-letter → -32602 before any call.", "maxLength": 2, "minLength": 2, "pattern": "^[A-Za-z]{2}$", "type": "string" }, "weatherreg": { "description": "City for weather. If omitted, the server tries IP-based geolocation of the caller. If geolocation fails, the weather block is skipped and logged in errors[].", "maxLength": 100, "minLength": 1, "type": "string" } }, "type": "object" }, "name": "get_day_summary", "outputSchema": { "additionalProperties": false, "properties": { "blocks": { "additionalProperties": false, "description": "Successfully fetched blocks. Any subset of weather / indices / crypto / news. Blocks that failed are absent and listed in `errors`.", "properties": { "crypto": { "additionalProperties": false, "properties": { "coins": { "description": "Fixed set: bitcoin, ethereum, solana.", "items": { "additionalProperties": false, "properties": { "change24h": { "type": [ "number", "null" ] }, "id": { "type": "string" }, "priceUsd": { "type": [ "number", "null" ] } }, "required": [ "id", "priceUsd", "change24h" ], "type": "object" }, "maxItems": 3, "minItems": 1, "type": "array" } }, "required": [ "coins" ], "type": "object" }, "indices": { "additionalProperties": false, "properties": { "failed": { "description": "Only present when some symbols failed but at least one succeeded. ", "items": { "additionalProperties": false, "properties": { "description": "Seconds to wait before retrying this symbol.", "error": { "type": "string" }, "retryAfter": { "type": [ "string", "null" ] }, "symbol": { "type": "string" } }, "required": [ "symbol", "error" ], "type": "object" }, "maxItems": 3, "type": "array" }, "indices": { "description": "One entry per successfully fetched index. Fixed: ^GSPC, ^DJI, ^IXIC.", "items": { "additionalProperties": false, "properties": { "change": { "type": [ "number", "null" ] }, "changePercent": { "type": [ "number", "null" ] }, "name": { "type": "string" }, "price": { "type": "number" }, "symbol": { "type": "string" }, "updatedAt": { "type": [ "string", "null" ] } }, "required": [ "symbol", "name", "price", "change", "changePercent", "updatedAt" ], "type": "object" }, "maxItems": 3, "minItems": 1, "type": "array" } }, "required": [ "indices" ], "type": "object" }, "news": { "additionalProperties": false, "properties": { "articles": { "description": "Up to 5 latest headlines.", "items": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "image": { "type": [ "string", "null" ] }, "publishedAt": { "description": "ISO-like from provider, not RFC3339.", "type": "string" }, "source": { "type": [ "string", "null" ] }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "title", "description", "url", "source", "publishedAt", "image" ], "type": "object" }, "maxItems": 5, "type": "array" }, "region": { "description": "Region code that was applied (\"world\" if none).", "type": "string" } }, "required": [ "region", "articles" ], "type": "object" }, "weather": { "additionalProperties": false, "properties": { "location": { "type": "string" }, "temperature": { "type": "number" }, "time": { "description": "ISO-like local time from Open-Meteo, not RFC3339.", "type": "string" }, "weathercode": { "type": "integer" }, "winddirection": { "type": "number" }, "windspeed": { "type": "number" } }, "required": [ "location", "temperature", "windspeed", "winddirection", "weathercode", "time" ], "type": "object" } }, "type": "object" }, "errors": { "description": "Blocks that failed. Empty array when everything succeeded. ", "items": { "additionalProperties": false, "properties": { "block": { "enum": [ "weather", "indices", "crypto", "news" ], "type": "string" }, "error": { "type": "string" }, "retryAfter": { "description": "Seconds to wait before retrying this block.", "type": [ "string", "null" ] } }, "required": [ "block", "error" ], "type": "object" }, "maxItems": 4, "type": "array" }, "generatedAt": { "format": "date-time", "type": "string" }, "meta": { "additionalProperties": false, "properties": { "info": { "additionalProperties": false, "properties": { "contacts": { "format": "email", "type": "string" }, "openapi": { "type": "string" }, "x402": { "type": "string" } }, "required": [ "x402", "openapi", "contacts" ], "type": "object" }, "totalMs": { "type": "integer" } }, "required": [ "totalMs", "info" ], "type": "object" }, "status": { "enum": [ "ok" ], "type": "string" } }, "required": [ "status", "generatedAt", "blocks", "errors", "meta" ], "type": "object" } }, { "description": "Get your full account data: balance, digital purchases and paid calls. Use it when you need to audit your account: check balance, verify, or summarize what paid calls you have made - e.g. to check spend, find purchased codes, confirm a past payment settled, or list your recent endpoints or their parameters. Unlike other tools, this is the account-wide audit view keyed by `buyerID`, which is a bearer-style secret: it both authorizes charges against your prepaid `balance` (no 402 challenge when balance covers price) and unlocks this history. Treat it like a password - do not log it or share it. Tool returns aggregate counters plus per-route events (timestamp, endpoint, network, amount, facilitator, params). Free, read-only. Not a real-time payment-status probe - eventually-consistent history. Rate limit per IP: 15 calls / 10 min, exceeding → 429. User can also view it in a browser at https://x402helper.xyz/getmyhistory.html page.", "inputSchema": { "additionalProperties": false, "properties": { "buyerID": { "description": "16-char buyer ID you received as `meta.yourID` in any successful paid response - whether you called the endpoint directly over HTTP (e.g. https://x402helper.xyz/test-billing) or via the MCP tool `call_endpoint` (e.g. routeId `34f3gf:r1`).", "maxLength": 16, "minLength": 16, "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" } }, "required": [ "buyerID" ], "type": "object" }, "name": "get_my_history", "outputSchema": { "additionalProperties": false, "properties": { "balance": { "description": "Prepaid buyer balance (USDC) topped up via `top_up_balance` tool. When it covers price, paid calls and tools are charged directly from balance without the 402 challenge flow (X-Buyer-Id header). Null if never topped up / unavailable.", "type": [ "number", "string", "null" ] }, "buyerID": { "description": "16-char buyer ID (echo of the input).", "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" }, "firstSeenAt": { "type": [ "string", "null" ] }, "found": { "description": "False when no paid calls were recorded for this buyerID yet. Not an error.", "type": "boolean" }, "lastSeenAt": { "type": [ "string", "null" ] }, "meta": { "additionalProperties": false, "properties": { "contacts": { "description": "Support contact, e.g. \"[email protected]\".", "type": "string" }, "timestamp": { "description": "ISO 8601 server time of this response.", "type": "string" }, "yourID": { "description": "Echo of buyerID - provided for consistency with meta.yourID in paid responses.", "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" } }, "required": [ "timestamp", "contacts" ], "type": "object" }, "orders": { "additionalProperties": false, "description": "Digital purchases made via separate tools (e.g. buy_gift_cards tool). Empty objects when found=false or none purchased.", "properties": { "gift-cards": { "additionalProperties": true, "description": "Map: gift-card key → order data. Free-form per provider.", "type": "object" } }, "type": "object" }, "routes": { "additionalProperties": { "additionalProperties": false, "properties": { "calls": { "description": "Number of successful calls on this route.", "minimum": 0, "type": "integer" }, "events": { "description": "Chronological (oldest → newest) list of successful calls for this route. Capped at 500 most recent events per route.", "items": { "additionalProperties": false, "properties": { "amount": { "description": "Amount charged for this call, in the route currency (USDC). String form preferred; legacy records may be numeric.", "type": [ "string", "null" ] }, "endpoint": { "description": "Endpoint template as recorded at call time.", "type": [ "string", "null" ] }, "facilitator": { "description": "Facilitator that verified the payment: \"dexter\", \"coinbase\", or \"payai\".", "type": [ "string", "null" ] }, "network": { "description": "CAIP-2 network identifier the buyer paid on (e.g. \"eip155:8453\", \"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp\").", "type": [ "string", "null" ] }, "params": { "description": "Snapshot of call arguments: { path?: {...}, query?: {...}, body?: {...} }. Free-form per route. Null for legacy records.", "type": [ "object", "null" ] }, "ts": { "description": "ISO 8601 timestamp of the call.", "type": [ "string", "null" ] } }, "required": [ "ts", "endpoint", "network", "amount", "facilitator", "params" ], "type": "object" }, "type": "array" }, "firstCallAt": { "type": [ "string", "null" ] }, "lastCallAt": { "type": [ "string", "null" ] } }, "required": [ "calls", "firstCallAt", "lastCallAt", "events" ], "type": "object" }, "description": "Map: routeKey → per-route history. routeKey is either a short alias (r1, r2, …) or path template (e.g. \"/9da78c/api/ofac-wallet-screen/:address\"). Empty object when found=false.", "type": "object" }, "status": { "enum": [ "ok" ], "type": "string" }, "successfulCalls": { "minimum": 0, "type": "integer" } }, "required": [ "status", "buyerID", "found", "successfulCalls", "routes", "meta" ], "type": "object" } }, { "description": "FREE search for paid API endpoints (x402) by task. Pass either a natural-language query (the planner will split it) or pre-split queries[]. Returns a structured plan with up to `maxRoutesPerQuery` candidates per sub-query. No auth. Limits: burst 200/10s, total 1000/15min per IP; free probes 10/h per IP, 20/h per agent. IMPORTANT: Do not fetch `route.url` directly. To execute the preferred route, call `call_endpoint({ routeId, arguments })` - `routeId` from `plan[].routes[].routeId`, `arguments` keys = `parameters[].name` of that route.", "inputSchema": { "properties": { "budget": { "description": "Optional filter to exclude expensive plans. If the cheapest possible plan (estimate.minPlanCost) exceeds maxTotalPrice, the plan is still returned but estimate.overBudget=true.", "properties": { "currency": { "default": "USDC", "description": "Currency for maxTotalPrice. Defaults to USDC.", "type": "string" }, "maxTotalPrice": { "description": "Maximum total price for the recommended routes, in `currency`. Set it to skip plans that are too expensive for your task.", "minimum": 0, "type": "number" } }, "type": "object" }, "maxRoutesPerQuery": { "default": 3, "description": "Max alternative routes returned per sub-query. Controls how many candidates you get to choose from; does not affect the discovery fee. Clamped to [1,5].", "maximum": 5, "minimum": 1, "type": "integer" }, "queries": { "description": "Optional pre-split sub-queries. If provided, takes precedence over `query` and bypasses the LLM planner (so faster). Use only when you already know the decomposition; otherwise omit and pass `query`.", "items": { "maxLength": 500, "minLength": 1, "type": "string" }, "maxItems": 8, "type": "array" }, "query": { "description": "Natural-language task. Pass the whole task in one call; the planner splits it into sub-queries automatically. Ignored if `queries` is provided.", "type": "string" } }, "type": "object" }, "name": "search_endpoints", "outputSchema": { "properties": { "budget": { "description": "Echo of the budget applied to this search (may have maxTotalPrice=null if not provided).", "properties": { "currency": { "type": "string" }, "maxTotalPrice": { "type": [ "number", "null" ] } }, "type": "object" }, "estimate": { "properties": { "currency": { "type": "string" }, "minPlanCost": { "description": "Sum of the cheapest route price per step - the minimum needed to cover every step.", "type": "number" }, "overBudget": { "description": "True if minPlanCost exceeds budget.maxTotalPrice. The plan is still returned.", "type": "boolean" }, "planTotal": { "description": "Sum of route.price over all recommended routes.", "type": "number" } }, "required": [ "currency", "planTotal", "minPlanCost", "overBudget" ], "type": "object" }, "meta": { "properties": { "budget": { "properties": { "maxPricePerRoute": { "description": "Hard filter applied during search: routes with price > this value were excluded before ranking.", "type": "number" }, "maxTotalPrice": { "type": [ "number", "null" ] } }, "type": "object" }, "composerMs": { "type": "integer" }, "info": { "properties": { "contacts": { "format": "email", "type": "string" }, "openapi": { "type": "string" }, "x402": { "type": "string" } }, "required": [ "openapi", "x402", "contacts" ], "type": "object" }, "maxRoutesPerQuery": { "maximum": 5, "minimum": 1, "type": "integer" }, "plannerMs": { "type": "integer" }, "plannerSource": { "enum": [ "llm", "client" ], "type": "string" }, "queriesCount": { "type": "integer" }, "ragMs": { "type": "integer" }, "routesConsidered": { "type": "integer" }, "routesRecommended": { "type": "integer" } }, "required": [ "plannerMs", "plannerSource", "ragMs", "composerMs", "queriesCount", "routesConsidered", "routesRecommended", "maxRoutesPerQuery", "budget", "info" ], "type": "object" }, "mode": { "enum": [ "discovery" ], "type": "string" }, "plan": { "description": "Ordered steps. Each step groups candidate routes for one sub-query. Empty array means no matching endpoints were found.", "items": { "properties": { "query": { "type": "string" }, "queryId": { "type": "string" }, "routes": { "items": { "properties": { "parameters": { "items": { "properties": { "default": {}, "description": { "type": [ "string", "null" ] }, "enum": { "items": {}, "type": [ "array", "null" ] }, "example": {}, "in": { "enum": [ "query", "path", "header", "cookie" ], "type": "string" }, "name": { "type": "string" }, "required": { "type": "boolean" }, "schema": { "description": "JSON Schema for this parameter.", "type": "object" } }, "required": [ "name", "in", "required", "schema" ], "type": "object" }, "type": "array" }, "requestBody": { "oneOf": [ { "type": "object" }, { "type": "null" } ] }, "route": { "properties": { "description": { "type": [ "string", "null" ] }, "method": { "type": "string" }, "price": { "description": "Price per call of this route, in USDC. Charged by call_endpoint, not by search_endpoints.", "type": "number" }, "score": { "description": "RAG distance (lower = better match). Routes are sorted by score within each step.", "type": "number" }, "url": { "description": "URL of the endpoint on x402helper.xyz. Do not fetch it directly - pass routeId to call_endpoint instead, which handles payment and required arguments.", "type": "string" } }, "required": [ "method", "url", "price", "description", "score" ], "type": "object" }, "routeId": { "type": "string" }, "routeIndex": { "minimum": 1, "type": "integer" }, "status": { "description": "recommended - route is indexed and its parameters/requestBody are known; safe to pass routeId to call_endpoint. unresolved - route came from search but is missing from the local index; its contract is unknown and call_endpoint will likely fail. Prefer another route in the same step.", "enum": [ "recommended", "unresolved" ], "type": "string" } }, "required": [ "routeIndex", "routeId", "route", "parameters", "requestBody", "status" ], "type": "object" }, "minItems": 1, "type": "array" }, "step": { "minimum": 1, "type": "integer" } }, "required": [ "step", "queryId", "query", "routes" ], "type": "object" }, "type": "array" }, "queries": { "items": { "properties": { "id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "id", "text" ], "type": "object" }, "minItems": 1, "type": "array" }, "status": { "enum": [ "ok" ], "type": "string" } }, "required": [ "status", "mode", "queries", "budget", "plan", "estimate", "meta" ], "type": "object" } }, { "description": "Top up your agent balance to speed up paid requests. The `amount` you pay here is not a per-call price: it is added to your balance and is drawn down across many future calls like the `call_endpoint` or `buy_gift_cards` tools. When the balance covers the tool/endpoint price, calls are charged directly from balance without the 402 challenge flow; a partial balance still yields a 402 for the shortfall - sign and retry as usual. Call once without payment - the response will contain `accepts` to sign, then retry with the signed payment. On success returns meta.historyUrl and meta.yourID - use it as `X-Buyer-Id` header on subsequent calls to our paid tools or endpoints to use balance. Note: free probes limited to 15 calls / 10 min per IP. Call it if you plan to use our tools regularly, skip it if not.", "inputSchema": { "additionalProperties": false, "properties": { "amount": { "description": "Amount in USDC to top up (e.g. 0.5, 1, 10). Max 6 decimals.", "maximum": 1000, "minimum": 0.01, "type": "number" } }, "required": [ "amount" ], "type": "object" }, "name": "top_up_balance", "outputSchema": { "properties": { "accepts": { "type": "array" }, "balance": { "properties": { "current": { "type": "string" }, "previous": { "type": "string" } }, "type": "object" }, "error": { "type": "string" }, "message": { "type": "string" }, "meta": { "properties": { "contacts": { "type": "string" }, "historyUrl": { "description": "Direct url where you can get all your data. For more info look `get_my_history` tool description.", "type": "string" }, "responseTimeMs": { "type": "integer" }, "timestamp": { "type": "string" }, "yourID": { "pattern": "^[0-9A-Za-z_-]{16}$", "type": "string" } }, "type": "object" }, "refunded": { "type": "boolean" }, "requiredArgs": { "type": "array" }, "status": { "enum": [ "ok", "payment_required", "error" ], "type": "string" }, "success": { "type": "boolean" }, "topup": { "properties": { "amount": { "type": "string" }, "currency": { "type": "string" }, "facilitator": { "type": "string" }, "network": { "type": "string" } }, "type": "object" }, "x402Version": { "type": "integer" } }, "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:bb89a7aa3b670a735197605db338f5cf902e5455c1ab8c3508790ed5a21e594a | sha256sum