Agent Nexus

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['need'], 'properties': {'need': {'type': 'string', 'maxLength': 300, 'minLength': 3, 'description': 'What the agent is trying to accomplish, in plain language. 3-300 characters, required.'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Maximum number of matching interfaces to return, 1-20. Default 5.'}, 'category': {'enum': ['api', 'mcp', 'cli'], 'type': 'string', 'description': "Restrict to one interface layer ('api', 'mcp' or 'cli' — see list_categories). Default: omitted, searches all three."}, 'min_reliability': {'type': 'integer', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Drop interfaces scoring below this 0-100 reliability value. Default 0 (no filter).'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['need', 'coverage', 'count', 'uncovered', 'note', 'matches'], 'properties': {'need': {'type': 'string'}, 'note': {'type': 'string'}, 'count': {'type': 'number'}, 'matches': {'type': 'array', 'items': {}}, 'coverage': {'type': 'string'}, 'uncovered': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 80, 'minLength': 1, '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."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entry'], 'properties': {'entry': {}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['categories'], 'properties': {'categories': {'type': 'array', 'items': {}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'default': 1, 'maximum': 9007199254740991, 'minimum': 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."}, 'category': {'enum': ['api', 'mcp', 'cli'], 'type': 'string', '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."}, 'per_page': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1, '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."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['total', 'page', 'per_page', 'pages', 'results'], 'properties': {'page': {'type': 'number'}, 'pages': {'type': 'number'}, 'total': {'type': 'number'}, 'results': {'type': 'array', 'items': {}}, 'per_page': {'type': 'number'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, '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.'}, 'query': {'type': 'string', 'default': '', 'maxLength': 120, '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."}, 'category': {'enum': ['api', 'mcp', 'cli'], 'type': 'string', 'description': "Optional filter, exactly one of 'api', 'mcp' or 'cli' (see list_categories). Combined with query as AND. Omit to search all three layers."}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['count', 'results'], 'properties': {'count': {'type': 'number'}, 'results': {'type': 'array', 'items': {}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name', 'category', 'summary', 'endpoint', 'auth_mode'], 'properties': {'name': {'type': 'string', 'maxLength': 80, 'minLength': 1, '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."}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 24, 'minLength': 1}, 'default': [], 'maxItems': 8, 'description': "Up to 8 short domain labels for browsing, e.g. ['email','messaging']. Domains, not actions — actions belong in capabilities[]."}, 'pricing': {'type': 'string', 'default': '', 'maxLength': 120, '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."}, 'summary': {'type': 'string', 'maxLength': 300, 'minLength': 10, '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')."}, 'category': {'enum': ['api', 'mcp', 'cli'], 'type': 'string', '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)."}, 'docs_url': {'type': 'string', 'format': 'uri', 'maxLength': 500, 'description': 'Absolute https URL of the developer documentation (not the marketing home page). Omit if none exists; submissions without it are approved more slowly.'}, 'endpoint': {'type': 'string', 'maxLength': 500, 'minLength': 1, '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."}, 'auth_mode': {'type': 'string', 'maxLength': 120, 'minLength': 1, '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."}, 'rate_limit': {'type': 'string', 'default': '', 'maxLength': 120, '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."}, 'auth_params': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'location'], 'properties': {'name': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': "Exact credential name as sent, e.g. 'Authorization' or 'api_key'."}, 'location': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': "Where the credential goes: 'header', 'query', 'env' (CLI/MCP environment variable) or 'flag' (CLI argument)."}, 'required': {'type': 'boolean', 'default': True, 'description': 'False only when the call also works without this credential. Defaults to true.'}}}, 'default': [], 'maxItems': 10, '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."}, 'description': {'type': 'string', 'default': '', 'maxLength': 4000, '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.'}, 'capabilities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40, 'minLength': 2}, 'default': [], 'maxItems': 12, '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."}, 'input_format': {'type': 'string', 'default': '', 'maxLength': 120, 'description': "MIME type or shape the interface accepts, e.g. 'application/json', 'multipart/form-data', 'command-line flags'. Empty string when not applicable."}, 'contact_email': {'type': 'string', 'format': 'email', '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,}$", 'maxLength': 200, 'description': 'Optional. Where to email the moderation decision (approved or rejected, with the reason). Never published, never shared.'}, 'output_format': {'type': 'string', 'default': '', 'maxLength': 120, 'description': "MIME type or shape the interface returns, e.g. 'application/json', 'text/csv', 'stdout text'. Empty string when not applicable."}, 'invocation_example': {'type': 'string', 'default': '', 'maxLength': 1000, '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.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug', 'status'], 'properties': {'slug': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': False}