PCC Gateway

{
  "protocolVersion": "1.0",
  "name": "PCC Gateway",
  "description": "Physical Capability Cloud \u2014 manufacturing capabilities as cloud services",
  "url": "https://capability.network/a2a",
  "version": "2.0.0",
  "preferredTransport": "http+sse",
  "provider": {
    "organization": "Physical Capability Cloud",
    "url": "https://capability.network"
  },
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "skills": [
    {
      "id": "pcc-discover",
      "name": "Capability Discovery",
      "description": "Discover and search physical manufacturing capabilities across the PCC network. Returns available capability types (3D printing, CNC machining, laser cutting, HPLC, liquid handling), active Shop Kernels, pricing, assurance tiers, and real-time queue depth.",
      "tags": [
        "discovery",
        "manufacturing",
        "search",
        "capabilities",
        "kernels",
        "physical-world"
      ],
      "examples": [
        "Find FDM 3D printers near Austin TX that can print PLA under $50",
        "List available CNC machining capabilities with assurance tier 2",
        "Search for liquid handling capabilities compatible with 96-well plates"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-quote",
      "name": "Capability Quoting",
      "description": "Get price quotes for physical capability contracts. Accepts capability type, material, parameters, quantity, deadline, and assurance tier. Returns itemized quote with operator bond, escrow amount, and validity window. Supports negotiation over A2A message bus.",
      "tags": [
        "quoting",
        "pricing",
        "manufacturing",
        "negotiation",
        "escrow"
      ],
      "examples": [
        "Quote FDM print: 100g PLA, 0.2mm layer height, assurance tier 1",
        "Get CNC quote for aluminum part, quantity 5, 48-hour turnaround",
        "Quote HPLC batch: 24 samples, USP compliance tier 3"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-submit",
      "name": "Job Submission and Tracking",
      "description": "Submit and track physical manufacturing jobs through the full lifecycle: pending \u2192 scheduled \u2192 in_progress \u2192 awaiting_verification \u2192 verified \u2192 completed. Supports milestone-based escrow funding, SSE streaming for real-time status updates, and batch job manifests.",
      "tags": [
        "job-submission",
        "workflow",
        "manufacturing",
        "tracking",
        "escrow",
        "milestones",
        "sse"
      ],
      "examples": [
        "Submit 3D print job with STL file, PLA material, 0.2mm resolution",
        "Stream real-time status for job job_abc123",
        "Submit multi-step protocol: PCR amplification then gel electrophoresis"
      ],
      "inputModes": [
        "application/json",
        "multipart/form-data"
      ],
      "outputModes": [
        "application/json",
        "text/event-stream"
      ]
    },
    {
      "id": "pcc-verify",
      "name": "Evidence Verification",
      "description": "Verify physical execution evidence bundles. Evidence is SHA-256 content-addressed, stored on Storacha/IPFS, optionally anchored to Starknet ZK proofs, and attested by the Bittensor verifier subnet. Supports photo verification (pHash+SSIM), sensor data, and human consensus.",
      "tags": [
        "verification",
        "evidence",
        "ipfs",
        "zk-proof",
        "bittensor",
        "storacha",
        "trust"
      ],
      "examples": [
        "Verify evidence bundle for job job_abc123",
        "Check ZK proof anchor for evidence CID bafyrei...",
        "Get Bittensor attestation scores for operator 0x1234..."
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-settle",
      "name": "Escrow and Settlement",
      "description": "Manage milestone escrow for physical capability contracts. Fund with USDC on Base Sepolia, release milestones after evidence verification, handle disputes and operator bond slashing. Supports x402 micropayments, NEAR cross-chain payment intents, and DePIN reward epochs.",
      "tags": [
        "escrow",
        "settlement",
        "payment",
        "usdc",
        "base",
        "depin",
        "x402",
        "near"
      ],
      "examples": [
        "Fund escrow for contract cap_xyz with 50 USDC on Base Sepolia",
        "Release milestone payment after verified evidence",
        "Check DePIN reward epoch and claim operator rewards"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-author-integration",
      "name": "Author an Integration",
      "description": "Onboard a new operator end-to-end: from a machine or human-skill description, register the kernel, publish the capability (with optional human-lane accept/deadline SLA, optional availability windows, and optional notification channels), and return the live A2A agent-card URL. Accepts channels[] and availability inline so a fully-formed operator can be onboarded in one call.",
      "tags": [
        "onboarding",
        "operator",
        "integration",
        "kernel",
        "capability",
        "physical-world",
        "channels",
        "availability"
      ],
      "examples": [
        "Publish my Opentrons OT-2 as a liquid-handling capability via generic-http",
        "List me as a same-day SF courier - accept within 90s, finish within 1h",
        "Publish my pizza shop with a webhook channel to my receipt printer and availability windows 9am-10pm daily"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-attach-channel",
      "name": "Attach a Notification Channel",
      "description": "Attach a notification/dispatch channel to an existing operator so PCC knows how to ping them when a job lands. Channels carry a small stable transport enum (webhook/email/sms/voice/push/mqtt/file/manual) plus a plain-English describe field the operator's onboarding agent fills in by conversation. PCC the substrate stays neutral on specific vendors \u2014 new backend types appear by conversation, not code change. Returns the channel record + a test-dispatch URL for end-to-end verification.",
      "tags": [
        "onboarding",
        "operator",
        "channel",
        "notification",
        "integration",
        "wire-protocol"
      ],
      "examples": [
        "Add a webhook channel for my pizza shop that POSTs to my receipt printer's local URL",
        "Add an SMS channel to my phone so I get pinged for new courier jobs",
        "Attach an MQTT topic on my lab's broker for incoming HPLC runs",
        "Add a manual channel (dashboard only) for my one-person studio"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-suggest-templates",
      "name": "Suggest Capability Templates",
      "description": "Bidirectional onboarding: the registry talks back. A user's agent describes in plain English what they're trying to set up (\"I'm publishing a wood-fired pizza shop\", \"I have an Opentrons OT-2\", \"I want to do same-day courier runs in SF\") and the registry returns N candidate CSD (Capability StructureDefinition) templates with relevance scores and usage attribution. The user's agent then picks one \u2014 or rolls a new template via POST /api/csd \u2014 and passes the chosen type to pcc-author-integration. Templates carry adoption counters (the marketplace data layer for future smart-contract gating + free/paid choice). Empty query returns popularity-ordered top picks.",
      "tags": [
        "onboarding",
        "templates",
        "csd",
        "registry",
        "discovery",
        "marketplace",
        "bidirectional"
      ],
      "examples": [
        "I'm setting up a wood-fired Neapolitan pizza shop in SF",
        "I have an Opentrons OT-2 I want to publish as a liquid-handling capability",
        "Show me the most-adopted human-skill templates",
        "I want to do same-day courier runs \u2014 what templates are close to that?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "documentationUrl": "https://capability.network/whitepaper.md",
  "iconUrl": "https://capability.network/icon.png",
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json",
    "text/event-stream"
  ],
  "securitySchemes": {
    "apiKey": {
      "type": "http",
      "scheme": "bearer",
      "description": "PCC API key (pcc_live_... or pcc_test_...). Provision at POST /api/auth/provision. Pass as: Authorization: Bearer pcc_live_<key>"
    },
    "siwe": {
      "type": "oauth2",
      "description": "Sign-In with Ethereum (SIWE / EIP-4361). Nonce at GET /api/auth/nonce, verify at POST /api/auth/verify. Returns session cookie or bearer token.",
      "flows": {
        "authorizationCode": {
          "authorizationUrl": "https://capability.network/api/auth/nonce",
          "tokenUrl": "https://capability.network/api/auth/verify",
          "scopes": {
            "operator": "Operator-level access (submit jobs, manage kernels)",
            "admin": "Admin-level access (reward epochs, slash bonds)"
          }
        }
      }
    },
    "x402": {
      "type": "http",
      "scheme": "bearer",
      "x-payment-protocol": "mpp",
      "x-network": "eip155:84532",
      "x-currency": "USDC",
      "x-recipient": "0x0000000000000000000000000000000000000001",
      "description": "Micropayment via MPP/Tempo on Base Sepolia. Price declared in WWW-Authenticate header on 402 response."
    }
  },
  "security": [
    {
      "apiKey": []
    },
    {
      "siwe": [
        "operator"
      ]
    }
  ],
  "supportsAuthenticatedExtendedCard": false,
  "x-erc8004": {
    "registered": false,
    "registryAddress": "0x8004A818BFB912233c491871b3d84c89A494BD9e",
    "chainId": 84532,
    "registrationUrl": "https://capability.network/.well-known/agent-registration.json"
  },
  "x-pcc-assurance-tiers": [
    0,
    1,
    2,
    3
  ],
  "x-pcc-networks": [
    "eip155:84532",
    "eip155:11155111",
    "near:testnet"
  ],
  "x-pcc-mcp-endpoint": "https://capability.network/mcp",
  "x-pcc-sse-endpoint": "https://capability.network/sse",
  "x-pcc-agent-package": "https://capability.network/agent-package.json"
}