Physical Capability Cloud

Physical Capability Cloud .well Known API

The .well Known API from Physical Capability Cloud — 11 operation(s) for .well known.

Documentation GitHub OpenAPI

Operations 11

GET /.well-known/agent-registration.json Get well known agent registration json #

GET /.well-known/agent-descriptions Get well known agent descriptions #

GET /.well-known/agent-card.json Google A2A Agent Card discovery document #

GET /.well-known/api-catalog RFC 9727 API catalog #

GET /.well-known/ai-catalog.json AI Catalog for PCC's live physical capabilities #

GET /.well-known/agent-directory.json PCC physical-capability agent directory #

GET /.well-known/mcp MCP server discovery #

GET /.well-known/mcp-registry-auth MCP Registry domain-ownership proof #

GET /.well-known/mcp/server-card.json MCP server card #

GET /.well-known/agent-skills/index.json Agent Skills discovery index #

GET /.well-known/jwks.json A2A v1.0 Agent Card signing JWKS (public) #

Specifications

⚙

OpenAPI

https://artifacts.apis.io/capability-network/openapi/capability-network-well-known-api-openapi.yml

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/capability-network:capability-network-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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Physical Capability Cloud Gateway .well Known API
  version: 0.1.0
  description: Agent-native API for discovering and invoking physical capabilities. See https://capability.network/agent-package.json for the 254-tool agent package.
servers:
- url: https://capability.network
tags:
- name: .well Known
paths:
  /.well-known/agent-registration.json:
    get:
      operationId: get_well_known_agent_registration_json
      responses:
        '200':
          description: Default Response
      tags:
      - .well Known
      summary: Get well known agent registration json
      x-summary-source: derived
  /.well-known/agent-descriptions:
    get:
      operationId: get_well_known_agent_descriptions
      responses:
        '200':
          description: Default Response
      tags:
      - .well Known
      summary: Get well known agent descriptions
      x-summary-source: derived
  /.well-known/agent-card.json:
    get:
      operationId: get_well_known_agent_card_json
      summary: Google A2A Agent Card discovery document
      tags:
      - .well Known
      description: Returns the A2A protocol Agent Card declaring PCC's capabilities, skills (discover/quote/submit/verify/settle), payment support, and security schemes. Used by agent-to-agent discovery. See https://google.github.io/A2A/. PUBLIC.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  protocolVersion:
                    type: string
                  name:
                    type: string
                  description:
                    type: string
                  url:
                    type: string
                  version:
                    type: string
                  preferredTransport:
                    type: string
                  provider:
                    type: object
                    additionalProperties: true
                  capabilities:
                    type: object
                    additionalProperties: true
                  skills:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
  /.well-known/api-catalog:
    get:
      operationId: get_well_known_api_catalog
      summary: RFC 9727 API catalog
      tags:
      - .well Known
      description: Public RFC 9264 linkset pointing to PCC's live API description and documentation.
      responses:
        '200':
          description: Default Response
  /.well-known/ai-catalog.json:
    get:
      operationId: get_well_known_ai_catalog_json
      summary: AI Catalog for PCC's live physical capabilities
      tags:
      - .well Known
      description: Generates an Agentic Resource Discovery AI Catalog from PCC's canonical capability-type registry at request time.
      responses:
        '200':
          description: Default Response
  /.well-known/agent-directory.json:
    get:
      operationId: get_well_known_agent_directory_json
      summary: PCC physical-capability agent directory
      tags:
      - .well Known
      description: Lists PCC's physical-capability discovery agent and its real discovery and A2A endpoints.
      responses:
        '200':
          description: Default Response
  /.well-known/mcp:
    get:
      operationId: get_well_known_mcp
      summary: MCP server discovery
      tags:
      - .well Known
      description: Describes PCC's public Streamable HTTP MCP server and repository-hosted stdio transport.
      responses:
        '200':
          description: Default Response
  /.well-known/mcp-registry-auth:
    get:
      operationId: get_well_known_mcp_registry_auth
      summary: MCP Registry domain-ownership proof
      tags:
      - .well Known
      description: Ed25519 public-key record so PCC can publish to the official MCP Registry via HTTP domain authentication.
      responses:
        '200':
          description: Default Response
  /.well-known/mcp/server-card.json:
    get:
      operationId: get_well_known_mcp_server_card_json
      summary: MCP server card
      tags:
      - .well Known
      description: Generates PCC's MCP server card from the current agent tool package.
      responses:
        '200':
          description: Default Response
  /.well-known/agent-skills/index.json:
    get:
      operationId: get_well_known_agent_skills_index_json
      summary: Agent Skills discovery index
      tags:
      - .well Known
      description: Generates the Agent Skills discovery index from the current agent tool package.
      responses:
        '200':
          description: Default Response
  /.well-known/jwks.json:
    get:
      operationId: get_well_known_jwks_json
      summary: A2A v1.0 Agent Card signing JWKS (public)
      tags:
      - .well Known
      description: JSON Web Key Set containing the public key(s) used to sign this issuer's A2A Agent Card. Verifiers fetch this to verify a card's JWS signature. PUBLIC, no auth.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  keys:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
components:
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: PCC API key (pcc_live_...). Provision at POST /api/auth/provision.
x-payment-info:
  description: Machine-payment metadata for deployment-configured paid routes. MPP is the current default; x402 v2 remains a real legacy opt-in transport.
  discovery: https://capability.network/api/x402/routes
  x402:
    version: 2
    status: legacy-opt-in
    network: eip155:84532
    currency: USDC
    requestHeader: PAYMENT-SIGNATURE
    challengeHeader: PAYMENT-REQUIRED
  mpp:
    status: default-when-configured
    challengeHeader: WWW-Authenticate
    credentialHeader: Authorization