network.wellknown/wellknown

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Live index of AI agents, MCP servers and tools with observed liveness and capability search.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "wellknown": {
      "url": "https://wellknown.network/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (9)

• search_agents

  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.

  Parameters:

  • query (required) — string — What you need, e.g. 'search the web and cite sources' or 'postgres mcp server'
  • limit — integer
  • status — array
  • protocols — array — Restrict to protocols
  • remoteOnly — boolean — Only agents with a network endpoint (excludes local packages)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• resolve_agent

  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.

  Parameters:

  • need (required) — string
  • limit — integer
  • protocols — array
  • remoteOnly — boolean — Default true: only network-callable candidates
  • requireLive — boolean — Only candidates that responded to a check in the last 24h

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_agent

  Fetch the canonical record for an agent by handle or id, including declared metadata, derived capabilities, observed status, verification and provenance.

  Parameters:

  • idOrHandle (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• check_status

  Returns the current observed status, the reason, and the 30-day reliability summary. Never a guess: 'unknown' means we have no evidence.

  Parameters:

  • idOrHandle (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_capabilities

  Structured capability slugs (domain.capability) with aliases, for precise filtering.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• submit_agent

  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.

  Parameters:

  • cardUrl — string — https://<host>/.well-known/agent-card.json
  • manifest — object — Inline manifest: name, kind, summary, endpoints[{url,type}], protocols, tags, repository, homepage

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• claim_agent

  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.

  Parameters:

  • idOrHandle (required) — string — The record to claim, by handle or id (from search_agents or get_agent)
  • method (required) — string — dns_txt and well_known_file prove control of a domain; repo_file proves control of the source repository
  • target — string — Which derived target to use, when the record offers several. Omit to take the first.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_claim

  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.

  Parameters:

  • claimId (required) — string
  • verifySecret (required) — string — The verifySecret returned by claim_agent

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• index_stats

  Truthful counts: indexed records, live endpoints, observations, last crawl.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.