Nevermined Well Known API

The Well-Known API from Nevermined — 8 operation(s) for well-known.

GitHub OpenAPI

Operations 8

GET /.well-known/ai-catalog.json ARD catalog (platform root, or per-org on a branded subdomain) #
GET /.well-known/agent-services-catalog.json ARD catalog for the curated Agent Services Catalog #
GET /.well-known/ard.json ARD catalog at the normative /.well-known/ard.json path #
GET /.well-known/llms.txt Per-org llms.txt (on a branded subdomain) #
GET /.well-known/agentic-instructions.md Per-org agentic-instructions.md (on a branded subdomain) #
GET /.well-known/jwks.json Get JSON Web Key Set (JWKS) #
GET /.well-known/oauth-authorization-server Get OAuth Authorization Server metadata #
GET /.well-known/oauth-protected-resource Get OAuth Protected Resource metadata #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/nevermined-app:nevermined-app-well-known-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nevermined-app-well-known-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: NVM BACKEND Well Known API
  description: ''
  version: 1.103.0
  contact: {}
servers:
- url: https://api.live.nevermined.app
tags:
- name: .well Known
paths:
  /.well-known/ai-catalog.json:
    get:
      description: On the API host, returns the Nevermined platform Agentic Resource Discovery (ARD) root catalog (one nested entry per organization with published agents/plans). On a per-org branded subdomain (`.api..nevermined.app`), returns that organization's own catalog. Public endpoint — no authentication required.
      operationId: WellKnownController_aiCatalog
      parameters: []
      responses:
        '200':
          description: ARD ai-catalog.json document (root or per-org)
          content:
            application/json:
              schema:
                type: object
      summary: ARD catalog (platform root, or per-org on a branded subdomain)
      tags:
      - .well Known
  /.well-known/agent-services-catalog.json:
    get:
      description: Google Agentic Resource Discovery (ARD) document listing the Nevermined-curated external agent services (x402 / MPP / REST / A2A). Public endpoint — no authentication required.
      operationId: WellKnownController_agentServicesCatalog
      parameters: []
      responses:
        '200':
          description: ARD ai-catalog.json document for the curated services
          content:
            application/json:
              schema:
                type: object
      summary: ARD catalog for the curated Agent Services Catalog
      tags:
      - .well Known
  /.well-known/ard.json:
    get:
      description: The Nevermined-curated Agent Services Catalog served at the Agentic Resource Discovery spec’s normative /.well-known/ard.json path. Identical document to agent-services-catalog.json. Public endpoint — no authentication required.
      operationId: WellKnownController_ardJson
      parameters: []
      responses:
        '200':
          description: ARD document for the curated Agent Services Catalog
          content:
            application/json:
              schema:
                type: object
      summary: ARD catalog at the normative /.well-known/ard.json path
      tags:
      - .well Known
  /.well-known/llms.txt:
    get:
      description: Served on a per-org branded subdomain (`.api..nevermined.app`); resolves to that organization's llms.txt. Returns 404 on the bare API host. Public endpoint.
      operationId: WellKnownController_llmsTxt
      parameters: []
      responses:
        '200':
          description: llms.txt content (plain text)
        '404':
          description: Not a per-org subdomain, or org not found / not paid
      summary: Per-org llms.txt (on a branded subdomain)
      tags:
      - .well Known
  /.well-known/agentic-instructions.md:
    get:
      description: Served on a per-org branded subdomain; resolves to that organization's agentic-instructions.md. Returns 404 on the bare API host. Public endpoint.
      operationId: WellKnownController_agenticInstructionsMd
      parameters: []
      responses:
        '200':
          description: agentic-instructions.md content (markdown)
        '404':
          description: Not a per-org subdomain, or org not found / not paid
      summary: Per-org agentic-instructions.md (on a branded subdomain)
      tags:
      - .well Known
  /.well-known/jwks.json:
    get:
      description: Returns the JSON Web Key Set used by OAuth clients to verify the JWTs issued by this authorization server. Public endpoint — no authentication required.
      operationId: WellKnownController_getJWKS
      parameters: []
      responses:
        '200':
          description: Returns the JSON Web Key Set
          content:
            application/json:
              schema:
                type: object
                properties:
                  keys:
                    type: array
                    items:
                      type: object
                      properties:
                        kty:
                          type: string
                        use:
                          type: string
                        kid:
                          type: string
                        n:
                          type: string
                        e:
                          type: string
                        alg:
                          type: string
      summary: Get JSON Web Key Set (JWKS)
      tags:
      - .well Known
  /.well-known/oauth-authorization-server:
    get:
      description: Returns the OAuth 2.0 Authorization Server metadata document (RFC 8414), providing discovery information such as endpoints and supported grant types for OAuth clients. Public endpoint — no authentication required.
      operationId: WellKnownController_getOAuthAuthorizationServer
      parameters: []
      responses:
        '200':
          description: Returns OAuth Authorization Server metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  issuer:
                    type: string
                  authorization_endpoint:
                    type: string
                  token_endpoint:
                    type: string
                  jwks_uri:
                    type: string
                  response_types_supported:
                    type: array
                    items:
                      type: string
                  response_modes_supported:
                    type: array
                    items:
                      type: string
                  grant_types_supported:
                    type: array
                    items:
                      type: string
                  token_endpoint_auth_methods_supported:
                    type: array
                    items:
                      type: string
                  code_challenge_methods_supported:
                    type: array
                    items:
                      type: string
                  revocation_endpoint:
                    type: string
                  device_authorization_endpoint:
                    type: string
                  client_id_metadata_document_supported:
                    type: boolean
                  authorization_response_iss_parameter_supported:
                    type: boolean
      summary: Get OAuth Authorization Server metadata
      tags:
      - .well Known
  /.well-known/oauth-protected-resource:
    get:
      description: 'Returns the OAuth 2.0 Protected Resource Metadata document (RFC 9728) for this API as a resource server: its resource identifier, the authorization server(s) that mint credentials it accepts, and the supported bearer method. Public endpoint — no authentication required.'
      operationId: WellKnownController_getOAuthProtectedResource
      parameters: []
      responses:
        '200':
          description: Returns OAuth Protected Resource metadata
          content:
            application/json:
              schema:
                type: object
                properties:
                  resource:
                    type: string
                  authorization_servers:
                    type: array
                    items:
                      type: string
                  bearer_methods_supported:
                    type: array
                    items:
                      type: string
                  resource_documentation:
                    type: string
      summary: Get OAuth Protected Resource metadata
      tags:
      - .well Known
components:
  securitySchemes:
    Authorization:
      scheme: bearer
      bearerFormat: JWT
      type: http