# network.wellknown/wellknown

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

- name: network.wellknown/wellknown
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 93/100
- quality: 83/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/network.wellknown%2Fwellknown
- tools: https://api.protogrid.dev/v1/servers/network.wellknown%2Fwellknown/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "wellknown": {
      "type": "http",
      "url": "https://wellknown.network/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 100
- freshness: 85
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% ~updated-40d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 83/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: index_stats (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); resolve_agent (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); submit_agent (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 1,256 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 1 resolved packages
- n/a `deps.mcp_sdk_version`: the official MCP SDK is not in the dependency graph
- pass `deps.resolvable`: wellknown-mcp@0.1.0 resolved: 1 packages

- tools: 9, about 1,256 tokens to load them all
- tool set hash: 411e4aea607bffb1d93091474275a3fb
- badge: [![protogrid quality](https://protogrid.dev/badge/network.wellknown/wellknown.svg)](https://protogrid.dev/servers/network.wellknown/wellknown)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm wellknown-mcp@0.1.0: resolved, 0 dependencies

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://wellknown.network/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- npm wellknown-mcp@0.1.0 secrets: WELLKNOWN_API_KEY

## Tools (9)

- `check_status`: Returns the current observed status, the reason, and the 30-day reliability summary. Never a guess: 'unknown' means we have no evidence.
- `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.
- `get_agent`: Fetch the canonical record for an agent by handle or id, including declared metadata, derived capabilities, observed status, verification and provenance.
- `index_stats`: Truthful counts: indexed records, live endpoints, observations, last crawl.
- `list_capabilities`: Structured capability slugs (domain.capability) with aliases, for precise filtering.
- `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.
- `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.
- `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.
- `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.