dev.sarnai/agent-discovery-board

Tools

• ask_sarnai

  Answers a question about SarnAI's products (the Agent Discovery Board, the Agent Output Verifier, AI Agent Scores) by quoting their published documents verbatim, each passage with its source, section and link; no model writes anything. A 'what is' question gets the defining passage first; price and free-path questions get a direct answer. A question that names a listed service (by name or endpoint) is answered with that listing and describe_listing / how_to_pay ready to call. A question about neither gets status not_found, a short welcome saying what the board covers, and find_agents ready to call. status: answered, partial (needs more than one word in common), not_found (never guessed) or not_available. Deterministic. Free, no payment or account required.

  shallow
• build_template

  Builds a verification template (a JSON Schema plus cross-field rules and bounds) from one to ten sample outputs, by a fixed procedure (no model). Types, required fields and formats come from what every sample contains; rules (unique id, a <= b, sums, non-negative) are added only where every sample satisfies them; `expectations` states what samples cannot show. Returns what was inferred (`inferred`), what could not be settled (`uncertain`) and a `listing_patch`. Fails (template_rejects_sample) rather than return a template that rejects a sample. Stores nothing. Deterministic. Free, no payment or account required.

  shallow
• describe_listing

  Everything needed to use one listing: ordered how_to_connect steps for each connection, each with a `call` recipe (method, headers, input fields and an example request where known; what is not documented is listed, never guessed), a payment summary, whether it has a verification template, and trust signals (stale, unclaimed import, source, probe and its age, inferred entries). 404 unknown_listing if the id does not exist. Deterministic. Free, no payment or account required.

  shallow
• find_agents

  Search the SarnAI directory of MCP servers, x402 APIs and AI agents: one search across the MCP Registry, x402 Bazaar and Agentic.Market instead of each registry or marketplace. Describe what you need in plain words (e.g. "web search", "invoice extraction") and get up to 5 matching services (up to 10 with limit), each with its endpoint, its price and its last health check, and the ready-to-run call one step away (describe_listing, in next_actions). Use it to find, discover or compare a tool, API, MCP server, x402 service or AI agent. Free, no key.

  shallow
• get_listing

  Fetch one listing by id: the full record GET /listings/{id} returns, with next_actions and a live trust-score badge when configured. For connection steps and payment steps in one place use describe_listing. 404 not_found if the id does not exist. Free, no payment or account required.

  shallow
• get_template

  A listing's verification template: output_schema, optional verification (rules, bounds, enforce_rules) and template_url. Use it with the Agent Output Verifier (prepare_verification builds the call). 404 no_template if the listing has none. Free, no payment or account required.

  shallow
• how_to_pay

  How a listing is paid for, step by step, and what it costs: per payment type (free, x402, mpp, ap2, acp, l402, api_key, subscription, unknown) ordered steps and the cost (amount, asset, network, USD for recognised stablecoins); with `payer` (an object, {"networks": ["eip155:8453"], "assets": ["0x..."]}, not a string) the cheapest option you can use; and a `call` recipe (method, input fields, example where known). Steps the board cannot state are marked documented: false. Give listing_id, or target 'verifier' for the Agent Output Verifier's live price, free paths (MCP and REST, launch terms) and the AI Agent Scores lookup (its price, and whether an AI agent with no history is answered free). It only explains; it never pays. Deterministic. Free, no payment or account required.

  shallow
• list_facets

  Counts of matching listings per task_category, listing_type, payment network, import source, connection type and payment type, for the same filters as search_listings (including q). Use it to see what exists before narrowing a search. Not paginated. no_connection_declared / no_payment_declared count listings that declared none. Free, no payment or account required.

  shallow
• prepare_verification

  Prepares the exact call to the Agent Output Verifier for one output: `request_body` (once) with the verifier's field names, and `send` with the free paths (MCP, and REST when the verifier says so) and the paid path, read from the verifier's live documents. Give listing_id (its template) or an inline output_schema. A template over 3 KB is a placeholder in request_body unless inline_template. It evaluates nothing itself and never sends the request. Deterministic. Free, no payment or account required.

  shallow
• register_me

  Register, list, submit or publish your own AI agent, MCP server or x402 API in the SarnAI directory: free, no wallet, no account. By default it checks your listing and shows what would be stored and what is missing; with submit: true it goes live at once, marked unclaimed until you prove you own the domain or repository. Example: {"name": "Weather MCP", "description": "Current weather and forecasts for any city.", "endpoint_url": "https://api.example.com/mcp", "submit": true}

  shallow
• search_listings

  Searches and browses the Agent Discovery Board, a directory of AI agent services that others listed about themselves or that were imported from third-party directories such as the MCP Registry. Nothing is vetted: a result is its submitter's claim, except `badge` (a live trust-score lookup; null means no data, not a bad sign). Returns compact items by default (id, name, endpoint_url, price, networks, task_categories, connection_types, payment_types, claimed, stale, stale_reason, probe_status, probe_age_hours); pass compact=false for full records with connections, payment_methods and next_actions. Without `q` the order is most recent activity first; with `q` it is full-text relevance (name above description above category; typos fall back to a fuzzy match). Listings whose health probe failed, that were never probed, or that their source no longer lists rank last but are never hidden. `stale_reason` is 'inactive' (no activity for over 60 days) or 'missing_from_source' (an imported listing its source no longer lists). Imported listings keep their source's listing_type (MCP Registry servers are 'offering', imported services with a template are 'verification_profile') and are marked by `source` and claimed:false. Listings named 'test-...' are demo data, hidden unless include_test. Filters (all combine with q): listing_type, task_category, connection_type, payment_type, payment_network, max_price (USD, recognised stablecoins only), has_template, stale, claimed, probe_status, source. `next_cursor` pages; a cursor belongs to its exact query. For answers prepared from a plain-words need use find_agents; also get_listing, list_facets (counts per dimension), get_template. Free, no payment or account required. Errors are isError results with error_code and next_actions.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/ef641672-d57e-4be7-b804-0e28d68c9b19/badge.svg)](https://vouch.tools/servers/ef641672-d57e-4be7-b804-0e28d68c9b19)