discovery

Search the index by natural-language capability or task

get/search

Request

  • Base URL: https://wellknown.network/api/v1
  • URL: https://wellknown.network/api/v1/search
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

qstring

Natural-language need or keywords, in any language or script, e.g. search the web and cite sources.

capabilitystring

Capability slug(s) from the taxonomy, comma-separated (domain or domain.capability).

protocol'mcp' | 'a2a' | 'openapi' | 'http'

Protocol filter, comma-separated.

status'live' | 'recently_observed' | 'unavailable' | 'unknown'

Observed status filter, comma-separated.

kind'agent' | 'mcp_server' | 'tool' | 'api'

Record kind filter.

categorystring

Top-level capability domain.

remote'true' | 'false'

true to require a network endpoint (exclude local packages).

claimed'true' | 'false'

true to require a verified owner.

languagestring

ISO 639-1 code of the record's detected language (e.g. zh, ja, es). Queries in any script are accepted; non-Latin queries are matched on a language-neutral index.

limitinteger

1–100, default 20.

offsetinteger

Pagination offset.

sort'relevance' | 'recent' | 'name'

relevance (default), recent, name.

Response

OK

querystring
interpretationobject
totalinteger
countinteger
offsetinteger
facetsobject
tookMsinteger

Example response

{
  "results": [
    {
      "id": "ag_v3bzkm6gafcr",
      "capabilities": [
        {
          "slug": "content.localization"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.