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.

read-only

Argument	Type	Description
limit	integer	How many passages to return (1-5).
product	string	Search only the documents of one product. Omit to search them all.
agent_id	string	Optional label for yourself (usage statistics only).
question*	string	A question about the Agent Discovery Board, the Agent Output Verifier, AI Agent Scores or a listed service (by name or endpoint), in plain words.
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "question"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 3,
      "maximum": 5,
      "minimum": 1,
      "description": "How many passages to return (1-5)."
    },
    "product": {
      "enum": [
        "board",
        "verifier",
        "scores"
      ],
      "type": "string",
      "description": "Search only the documents of one product. Omit to search them all."
    },
    "agent_id": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional label for yourself (usage statistics only)."
    },
    "question": {
      "type": "string",
      "maxLength": 500,
      "minLength": 3,
      "description": "A question about the Agent Discovery Board, the Agent Output Verifier, AI Agent Scores or a listed service (by name or endpoint), in plain words."
    },
    "trace_id": {
      "type": "string",
      "description": "trace_id from a previous response, to continue a conversation; omit on the first call."
    }
  }
}

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.

read-only

Argument	Type	Description
name	string	Optional title for the schema.
samples	array	One to 10 example outputs of your service, as JSON (at most 32 KB in all). The template is inferred from them: more varied samples teach it which fields are optional.
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.
expectations	any	Things you know that samples cannot show: required fields, unique array fields, numeric ranges.

Input schema (JSON)

{
  "type": "object",
  "$defs": {
    "Range": {
      "type": "object",
      "properties": {
        "max": {
          "type": "number"
        },
        "min": {
          "type": "number"
        }
      },
      "additionalProperties": false
    },
    "Expectations": {
      "type": "object",
      "properties": {
        "ranges": {
          "type": "object",
          "description": "Numeric field path -> {min, max} bounds.",
          "maxProperties": 50,
          "additionalProperties": {
            "$ref": "#/$defs/Range"
          }
        },
        "required": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "Field paths that must be required in the schema."
        },
        "unique_fields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxItems": 50,
          "description": "Array field paths whose values must be unique, e.g. items[].sku."
        }
      },
      "additionalProperties": false
    }
  },
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional title for the schema."
    },
    "samples": {
      "type": "array",
      "items": {},
      "description": "One to 10 example outputs of your service, as JSON (at most 32 KB in all). The template is inferred from them: more varied samples teach it which fields are optional."
    },
    "agent_id": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional label for yourself (usage statistics only)."
    },
    "trace_id": {
      "type": "string",
      "description": "trace_id from a previous response, to continue a conversation; omit on the first call."
    },
    "expectations": {
      "$ref": "#/$defs/Expectations",
      "description": "Things you know that samples cannot show: required fields, unique array fields, numeric ranges."
    }
  }
}

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.

read-only

Argument	Type	Description
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.
listing_id*	string	A listing id (UUID), e.g. from find_agents.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "maxLength": 100,
      "description": "Optional label for yourself (usage statistics only)."
    },
    "trace_id": {
      "type": "string",
      "description": "trace_id from a previous response, to continue a conversation; omit on the first call."
    },
    "listing_id": {
      "type": "string",
      "description": "A listing id (UUID), e.g. from find_agents."
    }
  }
}

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.

read-only

Argument	Type	Description
need	string	What you need done, in plain words, at most 300 characters, e.g. 'a free MCP server that checks invoices'. Words for connection type, payment type, network and task rank matching services higher (none is left out); a price cap or 'no api key' is a filter (the response shows which). A listing's exact name finds that listing first.
limit	integer	How many matches to return (1-10).
source	array	Where the listing came from (any of), e.g. mcp_registry, x402_bazaar; 'none' for directly submitted ones.
network	string	CAIP-2 chain id the service must accept payment on, e.g. 'eip155:8453'.
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string

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.

read-only

Argument	Type	Description
listing_id*	string	The listing's id (a UUID), e.g. from search_listings.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "The listing's id (a UUID), e.g. from search_listings."
    }
  }
}

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.

read-only

Argument	Type	Description
listing_id*	string	The listing's id (a UUID), e.g. from search_listings.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "The listing's id (a UUID), e.g. from search_listings."
    }
  }
}

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.

read-only

Argument	Type	Description
payer	any	Optional. What you can pay with, used to pick the cheapest option you can use. An OBJECT, not a string: {"networks": ["eip155:8453"], "assets": ["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"]}. Leave it out to see every option.
target	string	'verifier': the Agent Output Verifier's own price and free path.
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.
listing_id	string	A listing id (UUID). Give this or target.

Input schema (JSON)

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.

read-only

Argument	Type	Description
q	string	Same search as search_listings.
stale	boolean	Filter by `stale`.
source	array	Import source, or 'none'.
status	string	'active' (default) or 'inactive'.
claimed	boolean	As in search_listings.
max_price	number	As in search_listings.
has_template	boolean	Has a verification template.
include_test	boolean	Also include temporary test listings.
listing_type	string

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.

read-only

Argument	Type	Description
task_id	string	Your identifier for this check; derived from the content if omitted.
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.
listing_id	string	Verify against this listing's template. Give this or output_schema.
verification	object	Inline {rules, bounds, enforce_rules} to go with output_schema.
output_schema	object	An inline JSON Schema to verify against (instead of listing_id).
inline_template	boolean

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}

Argument	Type	Description
name	string	The listing's name (at most 200 characters).
submit	boolean	false (default): only validate and prepare. true: create the listing now.
samples	array	Sample outputs of your service: when given without output_schema, build_template makes the template from them.
agent_id	string	Optional label for yourself (usage statistics only).
trace_id	string	trace_id from a previous response, to continue a conversation; omit on the first call.
connections	array	How to connect: [{type: mcp\|a2a\|rest\|x402, url, details?}].
description	string	What the service does (at most 2000 characters).
endpoint_url	string

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.

read-only

Argument	Type	Description
q	string	Plain-words search over name, description and categories; switches the order to relevance.
limit	integer

Agent Discovery Board by SarnAI

Try it

ask_sarnai Read-only

Agent Discovery Board by SarnAI

Try it

ask_sarnai Read-only

Tools (11)