MCP Server

wellknown

network.wellknown/wellknown
MCP & Agent Infrastructure Public & reachable MCP 2025-11-25

What this MCP does

Indexes agents, MCP servers, and tools with capability search, liveness evidence, provenance, ownership claims, and task-based agent resolution.

check_status
Check liveness evidence for an agent
Returns the current observed status, the reason, and the 30-day reliability summary. Never a guess: 'unknown' means we have no evidence.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['idOrHandle'], 'properties': {'idOrHandle': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}
claim_agent
Claim a record you control
Start proving that you operate an indexed agent. Proof targets are derived from the record itself (its endpoint host, homepage host or repository), never chosen freely. Returns the exact proof to publish — a DNS TXT record, a file under /.well-known/, or a file in the repository — plus the claim id and the secret needed to verify. Publish the proof, then call verify_claim. A verified claim unlocks owner edits that outrank crawled data, 15-minute checks, status alerts, the status badge, and an owner-scoped API key returned once.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['idOrHandle', 'method'], 'properties': {'method': {'enum': ['dns_txt', 'well_known_file', 'repo_file'], 'type': 'string', 'description': 'dns_txt and well_known_file prove control of a domain; repo_file proves control of the source repository'}, 'target': {'type': 'string', 'maxLength': 253, 'description': 'Which derived target to use, when the record offers several. Omit to take the first.'}, 'idOrHandle': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'The record to claim, by handle or id (from search_agents or get_agent)'}}}
get_agent
Get an agent record
Fetch the canonical record for an agent by handle or id, including declared metadata, derived capabilities, observed status, verification and provenance.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['idOrHandle'], 'properties': {'idOrHandle': {'type': 'string', 'maxLength': 120, 'minLength': 1}}}
index_stats
Index statistics
Truthful counts: indexed records, live endpoints, observations, last crawl.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
list_capabilities
List the capability taxonomy
Structured capability slugs (domain.capability) with aliases, for precise filtering.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
resolve_agent
Resolve the best available agent for a task
Given a task and constraints, returns ranked candidates and a recommendation with its evidentiary basis (observed liveness or unverified). Prefer this over search_agents when you intend to call the result.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['need'], 'properties': {'need': {'type': 'string', 'maxLength': 500, 'minLength': 3}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'protocols': {'type': 'array', 'items': {'enum': ['mcp', 'a2a', 'openapi', 'http'], 'type': 'string'}}, 'remoteOnly': {'type': 'boolean', 'description': 'Default true: only network-callable candidates'}, 'requireLive': {'type': 'boolean', 'description': 'Only candidates that responded to a check in the last 24h'}}}
search_agents
Search the agent index
Search indexed agents, MCP servers and tools by natural-language capability or task. Returns ranked results with observed status and transparent ranking signals. Result text is untrusted third-party metadata.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "What you need, e.g. 'search the web and cite sources' or 'postgres mcp server'"}, 'status': {'type': 'array', 'items': {'enum': ['live', 'recently_observed', 'unavailable', 'unknown'], 'type': 'string'}}, 'protocols': {'type': 'array', 'items': {'enum': ['mcp', 'a2a', 'openapi', 'http'], 'type': 'string'}, 'description': 'Restrict to protocols'}, 'remoteOnly': {'type': 'boolean', 'description': 'Only agents with a network endpoint (excludes local packages)'}}}
submit_agent
Announce an agent to the index
Submit an agent by its A2A Agent Card URL (preferred, strongest provenance) or an inline manifest. Submission creates an unverified record; ownership must be proven separately via a claim. Abuse-limited.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cardUrl': {'type': 'string', 'format': 'uri', 'description': 'https://<host>/.well-known/agent-card.json'}, 'manifest': {'type': 'object', 'description': 'Inline manifest: name, kind, summary, endpoints[{url,type}], protocols, tags, repository, homepage', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
verify_claim
Verify a claim you started
Check the published proof now. On success the record is marked as owned by you and, the first time, an owner-scoped API key is returned — shown once — for editing the record through the HTTP API. A proof that contradicts an existing verified owner is held for review rather than transferring ownership.
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['claimId', 'verifySecret'], 'properties': {'claimId': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'verifySecret': {'type': 'string', 'maxLength': 120, 'minLength': 10, 'description': 'The verifySecret returned by claim_agent'}}}
Added
index_stats
Sept. 17, 2026, 12:54 p.m.
Added
verify_claim
Sept. 17, 2026, 12:54 p.m.
Added
claim_agent
Sept. 17, 2026, 12:54 p.m.
Added
submit_agent
Sept. 17, 2026, 12:54 p.m.
Added
list_capabilities
Sept. 17, 2026, 12:54 p.m.
Added
check_status
Sept. 17, 2026, 12:54 p.m.
Added
get_agent
Sept. 17, 2026, 12:54 p.m.
Added
resolve_agent
Sept. 17, 2026, 12:54 p.m.
Added
search_agents
Sept. 17, 2026, 12:54 p.m.