---
title: "ARV discovery manifest"
method: GET
path: "/.well-known/arv"
---

# ARV discovery manifest

`GET /.well-known/arv`

## Request

- Base URL: `https://api.agentcdn.com`
- URL: `https://api.agentcdn.com/.well-known/arv`
- Auth: none declared

The first call an agent makes. `capabilities` lists exactly the tools that tools/list serves on `endpoints.mcp_server`.

## Response `200`

AgentCDN ARV discovery manifest.

- ArvWellKnownManifest
  - `arv` '1.0', required
  - `conformance_level` 'L1' | 'L2' | 'L3', required
  - `publisher` object, required
    - `name` string, required
    - `contact` string
  - `license_url` string, uri
  - `jwks_url` string, uri
  - `catalogs` string[], required
  - `tool_profiles` object
    - `mcp_origin` object
      - `url` string, uri, required
      - `version` string, required
    - `webmcp_page` object
      - `adapter` string, uri, required
      - `version` string, required
    - `nlweb` object
      - `ask` string, uri, required
    - `a2a` object
      - `card` string, uri, required
  - `validator_report` string, uri
  - `schema` string, uri
  - `entitlement_url` string, uri
  - `payment_terms_url` string, uri
  - `usage_url` string, uri
  - `arv_spec_version` string, required
  - `implementation` object, required
    - `name` string, required
    - `vendor` string, required
    - `operator_contact` string
  - `endpoints` object, required
    - `mcp_server` string, uri, required
    - `rest_base` string, uri, required
    - `trust_score_url` string, uri, nullable
    - `settlement_url` string, uri, nullable
    - `revocation_url` string, uri, nullable
    - `a2a_agent_card` string, uri, nullable
    - `openapi_spec` string, uri, nullable
    - `namespace_registry` string, uri, nullable
  - `capabilities` string[], required
  - `extensions` string[]
  - `supported_profiles` string[]
  - `payment_rails` string[]
  - `schema_version` 'arv@1.0', required

## Other responses

- `404`: A retired branded host answers 404. Error codes: not_found.

---

[API](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api.md) · [All operations](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api/revisions/f70f6777f2e5?raw)