PCC Gateway

{
  "protocolVersion": "1.0",
  "name": "PCC Gateway",
  "description": "Physical Capability Cloud \u2014 manufacturing capabilities as cloud services",
  "url": "https://capability.network/a2a/tasks/send",
  "version": "2.0.0",
  "preferredTransport": "JSONRPC",
  "provider": {
    "organization": "Physical Capability Cloud",
    "url": "https://capability.network"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "extendedAgentCard": false
  },
  "skills": [
    {
      "id": "discover_capability",
      "name": "Discover Physical Capabilities",
      "description": "Find real physical capabilities through POST /ask, GET /api/capabilities/search?q=, GET /api/capabilities/types, or POST /a2a/tasks/send with skill discover_capability.",
      "tags": [
        "discovery",
        "physical-capability",
        "search"
      ],
      "examples": [
        "Find a physical capability that can manufacture this part",
        "What laboratory capability is available for this protocol?"
      ],
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "hire_capability",
      "name": "Hire a Physical Capability",
      "description": "Hire a discovered capability through POST /a2a/tasks/send with skill hire_capability or submit directly at POST /api/jobs/submit.",
      "tags": [
        "hiring",
        "physical-capability",
        "job-submission"
      ],
      "examples": [
        "Hire the selected 3D-printing capability for this job"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "verify_evidence",
      "name": "Verify Physical Evidence",
      "description": "Assess execution evidence through POST /a2a/tasks/send with skill verify_evidence and retrieve job evidence at GET /api/evidence/:jobId.",
      "tags": [
        "verification",
        "evidence",
        "physical-capability"
      ],
      "examples": [
        "Verify the evidence for this completed physical job"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "pcc-discover",
      "name": "Capability Discovery",
      "description": "Discover and search physical capabilities across PCC's live registry. Invoke this skill at POST /a2a/tasks/send with skill pcc-discover, use POST /ask for natural-language discovery, or query GET /api/capabilities/search?q= and GET /api/capabilities/types.",
      "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": "Hire a discovered capability by invoking POST /a2a/tasks/send with skill pcc-submit, or submit directly at POST /api/jobs/submit, then track the physical job through its execution lifecycle.",
      "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"
      ]
    },
    {
      "id": "pcc-verify",
      "name": "Evidence Verification",
      "description": "Verify physical execution evidence by invoking POST /a2a/tasks/send with skill pcc-verify. Retrieve the real job evidence surface at GET /api/evidence/:jobId and use the returned bundles for assurance assessment.",
      "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"
      ]
    }
  ],
  "supportedInterfaces": [
    {
      "url": "https://capability.network/a2a/tasks/send",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "documentationUrl": "https://capability.network/whitepaper.md",
  "iconUrl": "https://capability.network/icon.png",
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "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"
      ]
    }
  ],
  "securityRequirements": [
    {
      "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",
  "x-pcc-core-skills": {
    "discover_capability": {
      "a2aSkill": "pcc-discover",
      "endpoints": [
        {
          "method": "POST",
          "url": "https://capability.network/ask"
        },
        {
          "method": "GET",
          "url": "https://capability.network/api/capabilities/search"
        },
        {
          "method": "GET",
          "url": "https://capability.network/api/capabilities/types"
        }
      ]
    },
    "hire_capability": {
      "a2aSkill": "pcc-submit",
      "endpoints": [
        {
          "method": "POST",
          "url": "https://capability.network/a2a/tasks/send"
        },
        {
          "method": "POST",
          "url": "https://capability.network/api/jobs/submit"
        }
      ]
    },
    "verify_evidence": {
      "a2aSkill": "pcc-verify",
      "endpoints": [
        {
          "method": "POST",
          "url": "https://capability.network/a2a/tasks/send"
        },
        {
          "method": "GET",
          "url": "https://capability.network/api/evidence/:jobId"
        }
      ]
    }
  }
}