Server definition
- Hash
- sha256:b90b117d78403848d077641bb93a02c25d0c686a51f6203de3204ace804a56e1
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Your allowance: 100 calls/day without a key (counted per IP, resets 00:00 UTC). A free key raises it to 1,000 calls/day — mint one in a single call with POST https://agentnexus.app/api/public/keys (no account needed) and send it as the x-api-key header. Reporting what happened when you called an interface earns +50 calls each (max +250/day): POST https://agentnexus.app/api/public/report or the report_invocation tool.\n\nAgent Nexus (https://agentnexus.app) is a registry of 650+ human-reviewed, continuously health-checked interfaces AI agents can call: HTTP APIs, MCP servers and CLIs. Start with discover_capabilities to map a plain-language need to callable interfaces, with endpoint, auth, formats, limits and a 0-100 reliability score. list_entries pages through the whole catalogue; search_registry does keyword lookup; get_entry returns one full contract. Agent Nexus is a registry, not a proxy: call the interface yourself, then report the outcome so reliability stays honest.\n\nBulk and mirror surfaces, no auth, no scraping needed:\n- whole catalogue in one call (NDJSON): https://agentnexus.app/api/public/entries.ndjson\n- prompt-ready text catalogue: https://agentnexus.app/llms.txt\n- capability vocabulary (what agents ask for): https://agentnexus.app/api/public/capabilities\n- newly approved interfaces feed: https://agentnexus.app/feed.xml\n- uptime history: https://agentnexus.app/api/public/status\n- OpenAPI 3.1: https://agentnexus.app/openapi.json\nRegistries and observatories are welcome to mirror these surfaces; please cite agentnexus.app as the source.\n\nTo submit your own interface, call submit_entry with a free agent key: mint one via POST https://agentnexus.app/api/public/keys and send it as the x-api-key header (1 submission per key and per source address per 24h; human-reviewed).",
"tools": [
{
"description": "Map a plain-language goal (e.g. 'send a transactional email') to callable APIs, MCP servers or CLIs. Returns {need, coverage, count, uncovered, note, matches[]}; each match has slug, endpoint, auth, formats, rate limit, pricing and a 0-100 reliability score. Never empty on a valid need: if nothing fits, coverage='none' and matches[] lists reliable starting points. Errors: an invalid or too-short need fails input validation; a backend failure returns isError=true with the message. Rate limits: 100 calls/day anonymous, 1,000/day with a free key (POST /api/public/keys, no account), 50,000/day on Agent Pro. For a known keyword or slug, use search_registry.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"description": "Restrict to one interface layer ('api', 'mcp' or 'cli' — see list_categories). Default: omitted, searches all three.",
"enum": [
"api",
"mcp",
"cli"
],
"type": "string"
},
"limit": {
"default": 5,
"description": "Maximum number of matching interfaces to return, 1-20. Default 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"min_reliability": {
"default": 0,
"description": "Drop interfaces scoring below this 0-100 reliability value. Default 0 (no filter).",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"need": {
"description": "What the agent is trying to accomplish, in plain language. 3-300 characters, required.",
"maxLength": 300,
"minLength": 3,
"type": "string"
}
},
"required": [
"need"
],
"type": "object"
},
"name": "discover_capabilities",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"coverage": {
"type": "string"
},
"matches": {
"items": {},
"type": "array"
},
"need": {
"type": "string"
},
"note": {
"type": "string"
},
"uncovered": {
"type": "boolean"
}
},
"required": [
"need",
"coverage",
"count",
"uncovered",
"note",
"matches"
],
"type": "object"
}
},
{
"description": "Fetch the full record of ONE approved registry entry whose exact slug you already have, e.g. from a previous discover_capabilities, search_registry or list_entries result. Read-only and idempotent: the same slug always returns the same entry until its health probe changes. Returns {entry} with endpoint, auth mode and parameters, input/output formats, rate limit, pricing, capabilities, docs URL, invocation example and the latest 6-hourly health probe — the detail level the listing tools omit. This is the single-record lookup: it takes no filters and no paging. If you do not have a slug, do not guess one — use search_registry for a keyword or discover_capabilities for a plain-language need; to walk the whole catalogue use list_entries. An unknown or unapproved slug is an error, not an empty result.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"slug": {
"description": "Exact lowercase slug of one entry, 1-80 chars, as returned in the 'slug' field of any other tool, e.g. 'stripe-api' or 'github-mcp'. Case-sensitive, no URL and no display name; only entries with status 'approved' resolve.",
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_entry",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"entry": {}
},
"required": [
"entry"
],
"type": "object"
}
},
{
"description": "Return the fixed taxonomy of Agent Nexus: the three interface layers it indexes ('api', 'mcp', 'cli'), each with a label, a one-line definition and its live count of approved entries. Read-only, idempotent and parameterless — call it once to learn the exact values accepted by the 'category' argument of search_registry, list_entries and discover_capabilities, and to size the catalogue before paging. It never returns entries themselves: use list_entries to enumerate a layer, search_registry for a keyword, discover_capabilities for a plain-language need.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "list_categories",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"categories": {
"items": {},
"type": "array"
}
},
"required": [
"categories"
],
"type": "object"
}
},
{
"description": "Enumerate the whole approved catalogue in deterministic slug order, page by page — use this when you want everything (mirroring, auditing, building your own index), not when you are looking for something specific. Read-only and idempotent. Returns {total, page, per_page, pages, results[]}: read 'pages' from the first response and increment 'page' until you reach it; 'total' and 'pages' reflect the 'category' filter when one is set, so keep the filter identical across pages or the paging shifts. Entries come back in summary form; call get_entry with a slug for the full record. For a keyword use search_registry, for a plain-language need use discover_capabilities, and for the accepted category values call list_categories. Bulk mirror alternative: GET https://agentnexus.app/api/public/entries.ndjson streams the full catalogue in one request.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"description": "Optional filter, exactly one of 'api', 'mcp' or 'cli' (see list_categories). Omit to page through all three layers. When set, 'total' and 'pages' count only that layer.",
"enum": [
"api",
"mcp",
"cli"
],
"type": "string"
},
"page": {
"default": 1,
"description": "1-based page index. Start at 1 and increment until it equals the 'pages' value returned in the response; a page beyond the last one returns an empty results[] rather than an error.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 25,
"description": "How many entries to return in this page, 1-50, default 25. Changing it between calls changes 'pages' and re-slices the catalogue, so keep it constant while paging.",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_entries",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"page": {
"type": "number"
},
"pages": {
"type": "number"
},
"per_page": {
"type": "number"
},
"results": {
"items": {},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"total",
"page",
"per_page",
"pages",
"results"
],
"type": "object"
}
},
{
"description": "Keyword lookup in the Agent Nexus registry when you already know what to look for: a product name, vendor, slug or endpoint fragment, optionally narrowed to one category. Matches literal text only — it does not interpret a goal. To go from a plain-language need to a callable interface, use discover_capabilities instead; to walk the whole catalogue in order use list_entries, and for the full record of one known slug use get_entry. Returns {count, results[]} in summary form, and an empty results[] when nothing matches — that is a valid answer, not an error.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"description": "Optional filter, exactly one of 'api', 'mcp' or 'cli' (see list_categories). Combined with query as AND. Omit to search all three layers.",
"enum": [
"api",
"mcp",
"cli"
],
"type": "string"
},
"limit": {
"default": 10,
"description": "Upper bound on entries returned, 1-50, default 10. Results are ordered by name, not by relevance, so a small limit on a broad keyword can hide better matches — raise it or use discover_capabilities when you are ranking candidates.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"query": {
"default": "",
"description": "Literal substring, max 120 chars, matched case-insensitively against name, summary, endpoint and slug — a product name ('resend'), a vendor, a slug fragment or a host ('api.stripe.com'). Single terms work best: the whole string is matched as one substring, so 'send email' finds nothing unless those words appear together. The characters % , ( ) are stripped. An empty query (the default) returns the first entries in name order, which is a browse, not a search.",
"maxLength": 120,
"type": "string"
}
},
"type": "object"
},
"name": "search_registry",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"results": {
"items": {},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
},
{
"description": "Register a new interface (HTTP API, MCP server or CLI) in the Agent Nexus catalogue. Callers authenticate either as a signed-in member or with a free agent key (POST https://agentnexus.app/api/public/keys), which allows one submission per key and per source address per 24 hours. This is a write: it creates a pending row, it does NOT publish anything — every submission is reviewed by a human before it becomes discoverable, so nothing you send here is visible to other agents until it is approved. Nothing is overwritten or deleted, and re-submitting the same name creates a second pending row rather than updating the first. Five fields are required (name, category, summary, endpoint, auth_mode); everything else is optional but directly decides whether the entry is approved and how well it ranks: capabilities[] is what other agents are matched against, so list concrete verbs, and docs_url plus invocation_example are what a reviewer checks first. Rate limited to 20 submissions per hour for members and 1 per 24 hours per agent key and per source address, and the endpoint must answer a live health probe to keep a reliability score. Returns {slug, status}; poll GET https://agentnexus.app/api/public/submission?slug=<slug> for the decision, or pass contact_email to be emailed instead. Use list_my_submissions to review what you already submitted; use search_registry first to check the interface is not already listed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"auth_mode": {
"description": "How a caller authenticates, in a few words: 'none', 'Bearer API key', 'API key in query', 'OAuth 2.1', 'Basic auth'. Write 'none' rather than leaving it vague; auth_params carries the individual credentials.",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"auth_params": {
"default": [],
"description": "Up to 10 individual credentials the caller must supply, each {name, location, required}. Leave empty when auth_mode is 'none'. Never include credential values here, only their names.",
"items": {
"properties": {
"location": {
"description": "Where the credential goes: 'header', 'query', 'env' (CLI/MCP environment variable) or 'flag' (CLI argument).",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"name": {
"description": "Exact credential name as sent, e.g. 'Authorization' or 'api_key'.",
"maxLength": 60,
"minLength": 1,
"type": "string"
},
"required": {
"default": true,
"description": "False only when the call also works without this credential. Defaults to true.",
"type": "boolean"
}
},
"required": [
"name",
"location"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"capabilities": {
"default": [],
"description": "Up to 12 lowercase hyphenated verbs an agent's need is matched against, e.g. ['send-email','list-templates','verify-address']. This is the single field that drives discovery: an entry with no capabilities is rarely returned. One action per item, 2-40 chars, no sentences.",
"items": {
"maxLength": 40,
"minLength": 2,
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"category": {
"description": "Which layer this interface belongs to: 'api' for an HTTP contract called directly, 'mcp' for a Model Context Protocol tool server, 'cli' for a command-line surface. Decides how endpoint is interpreted (URL vs command).",
"enum": [
"api",
"mcp",
"cli"
],
"type": "string"
},
"contact_email": {
"description": "Optional. Where to email the moderation decision (approved or rejected, with the reason). Never published, never shared.",
"format": "email",
"maxLength": 200,
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"description": {
"default": "",
"description": "Optional long form, max 4000 chars: what the interface does well, notable limits, quirks an agent should know before calling. Plain text; no HTML.",
"maxLength": 4000,
"type": "string"
},
"docs_url": {
"description": "Absolute https URL of the developer documentation (not the marketing home page). Omit if none exists; submissions without it are approved more slowly.",
"format": "uri",
"maxLength": 500,
"type": "string"
},
"endpoint": {
"description": "How the interface is actually reached, max 500 chars. For category 'api' the base URL (https://api.example.com/v1); for 'mcp' the server URL (https://example.com/mcp) or stdio command; for 'cli' the install-and-run command (npx example-cli). Must be reachable: it is probed daily and a dead endpoint loses its reliability score.",
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"input_format": {
"default": "",
"description": "MIME type or shape the interface accepts, e.g. 'application/json', 'multipart/form-data', 'command-line flags'. Empty string when not applicable.",
"maxLength": 120,
"type": "string"
},
"invocation_example": {
"default": "",
"description": "One copy-pasteable call that works: a curl command, a JSON-RPC body or a CLI line, max 1000 chars. Never include a real credential — use a placeholder such as $API_KEY. This is what reviewers check first.",
"maxLength": 1000,
"type": "string"
},
"name": {
"description": "Public product name as its vendor spells it, 1-80 chars, e.g. 'Resend' or 'GitHub MCP Server'. Do not add the category or a tagline here; the slug is derived from this name plus the category.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"output_format": {
"default": "",
"description": "MIME type or shape the interface returns, e.g. 'application/json', 'text/csv', 'stdout text'. Empty string when not applicable.",
"maxLength": 120,
"type": "string"
},
"pricing": {
"default": "",
"description": "Cost in one short phrase, e.g. 'Free', 'Free tier then $20/month', 'Usage-based, $0.001/call'. Agents filter on this, so be concrete.",
"maxLength": 120,
"type": "string"
},
"rate_limit": {
"default": "",
"description": "Published quota in the vendor's own words, e.g. '100 requests/minute', '10k calls/month on the free tier'. Leave empty rather than guessing.",
"maxLength": 120,
"type": "string"
},
"summary": {
"description": "One line an agent can rank on: what the interface does, 10-300 chars. State the capability, not the marketing (e.g. 'Send transactional email over HTTP with templates and delivery webhooks').",
"maxLength": 300,
"minLength": 10,
"type": "string"
},
"tags": {
"default": [],
"description": "Up to 8 short domain labels for browsing, e.g. ['email','messaging']. Domains, not actions — actions belong in capabilities[].",
"items": {
"maxLength": 24,
"minLength": 1,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"name",
"category",
"summary",
"endpoint",
"auth_mode"
],
"type": "object"
},
"name": "submit_entry",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"slug",
"status"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:b90b117d78403848d077641bb93a02c25d0c686a51f6203de3204ace804a56e1 | sha256sum