Physical Capability Cloud

Physical Capability Cloud Contract Builder API

The contract-builder API from Physical Capability Cloud — 3 operation(s) for contract-builder.

GitHub OpenAPI

Operations 3

POST /api/build/options Get parameter options for a capability type #
POST /api/build/price Calculate price for a configured capability #
POST /api/build/contract Build a complete capability contract #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/capability-network/openapi/capability-network-contract-builder-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-contract-builder-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

capability-network-contract-builder-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Physical Capability Cloud Gateway Contract Builder 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: contract-builder
paths:
  /api/build/options:
    post:
      operationId: post_api_build_options
      summary: Get parameter options for a capability type
      tags:
      - contract-builder
      description: Returns the parameter groups and allowed values for the given capability, optionally filtered by partial selections. Used to drive a multi-step configurator UI. Falls back to a generic quantity-and-notes form for ad-hoc capability types whose pricing comes from the capability row's pricingModel.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - type
              properties:
                type:
                  type: string
                  description: Capability type.
                selections:
                  type: object
                  additionalProperties: true
                  description: Partial selections to narrow available options.
                profileId:
                  type: string
                capabilityId:
                  type: string
                  description: Optional capability instance ID. Required for ad-hoc capability types so pricing comes from the right row.
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  options:
                    type: object
                    additionalProperties: true
  /api/build/price:
    post:
      operationId: post_api_build_price
      summary: Calculate price for a configured capability
      tags:
      - contract-builder
      description: Returns the itemized price (base + adjustments + currency) for the given selections without committing to a contract.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - type
              - selections
              properties:
                type:
                  type: string
                  description: Capability type.
                selections:
                  type: object
                  additionalProperties: true
                  description: Complete parameter selections.
                profileId:
                  type: string
                capabilityId:
                  type: string
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  pricing:
                    type: object
                    additionalProperties: true
  /api/build/contract:
    post:
      operationId: post_api_build_contract
      summary: Build a complete capability contract
      tags:
      - contract-builder
      description: Synchronously builds a contract for the given capability type with the provided parameter selections and assurance tier (0-3). Returns an unsigned contract ready for escrow funding via /api/escrow/fund.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - type
              - selections
              - assuranceTier
              properties:
                type:
                  type: string
                  description: Capability type (e.g. '3d-printing', 'cnc', 'hplc').
                selections:
                  type: object
                  additionalProperties: true
                  description: Parameter selections (material, infill, layerHeight...).
                assuranceTier:
                  type: integer
                  enum:
                  - 0
                  - 1
                  - 2
                  - 3
                  description: 0=self-attested, 1=verified, 2=certified, 3=sovereign.
                profileId:
                  type: string
                  description: Optional pricing profile override.
                capabilityId:
                  type: string
        required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                properties:
                  contract:
                    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