{
  "$schema": "https://runcouriers.com/schemas/capabilities.v1.json",
  "convention": "runcouriers-public-capabilities",
  "version": "1.0",
  "id": "https://runcouriers.com/capabilities.json",
  "canonicalOrigin": "https://runcouriers.com",
  "lastReviewed": "2026-10-11",
  "businessStage": "validation",
  "organization": {
    "id": "https://runcouriers.com#organization",
    "name": "RunCouriers",
    "legalName": "Run Couriers, LLC"
  },
  "protocols": {
    "supported": [
      "http"
    ],
    "notImplemented": [
      "MCP",
      "WebMCP",
      "OAuth",
      "A2A"
    ]
  },
  "resources": [
    {
      "id": "https://runcouriers.com#resource-site-profile",
      "url": "https://runcouriers.com/site.json",
      "method": "GET",
      "mediaType": "application/json",
      "description": "Canonical public profile, page registry, FAQ, planned models, and bounded provenance"
    },
    {
      "id": "https://runcouriers.com#resource-site-graph",
      "url": "https://runcouriers.com/site.jsonld",
      "method": "GET",
      "mediaType": "application/ld+json",
      "description": "JSON-LD for the same public entities and pages as the HTML site"
    },
    {
      "id": "https://runcouriers.com#resource-site-markdown",
      "url": "https://runcouriers.com/index.md",
      "method": "GET",
      "mediaType": "text/markdown",
      "description": "Readable site summary and complete FAQ"
    },
    {
      "id": "https://runcouriers.com#resource-llms-index",
      "url": "https://runcouriers.com/llms.txt",
      "method": "GET",
      "mediaType": "text/plain",
      "description": "Curated content links following the llms.txt proposal"
    },
    {
      "id": "https://runcouriers.com#resource-llms-full",
      "url": "https://runcouriers.com/llms-full.txt",
      "method": "GET",
      "mediaType": "text/plain",
      "description": "Expanded public profile, FAQ, and proposed corridor catalogue"
    },
    {
      "id": "https://runcouriers.com#resource-capabilities",
      "url": "https://runcouriers.com/capabilities.json",
      "method": "GET",
      "mediaType": "application/json",
      "description": "Project-convention public HTTP resources and gated actions"
    },
    {
      "id": "https://runcouriers.com#resource-openapi",
      "url": "https://runcouriers.com/openapi.json",
      "method": "GET",
      "mediaType": "application/json",
      "description": "OpenAPI 3.1 description of the three public web operations"
    },
    {
      "id": "https://runcouriers.com#resource-capabilities-schema",
      "url": "https://runcouriers.com/schemas/capabilities.v1.json",
      "method": "GET",
      "mediaType": "application/schema+json",
      "description": "Versioned JSON Schema for capabilities.json"
    },
    {
      "id": "https://runcouriers.com#resource-security-contact",
      "url": "https://runcouriers.com/.well-known/security.txt",
      "method": "GET",
      "mediaType": "text/plain",
      "description": "RFC 9116 security-reporting contact and fixed expiry"
    }
  ],
  "operations": [
    {
      "id": "https://runcouriers.com#capability-tracking",
      "operationId": "trackShipment",
      "method": "GET",
      "path": "/api/track",
      "limit": 10,
      "windowSeconds": 600,
      "url": "https://runcouriers.com/api/track",
      "effect": "read",
      "description": "Read the minimal public tracking result for a reference already known to the requester. Do not enumerate references.",
      "consentRequired": false,
      "requiresKnownReference": true
    },
    {
      "id": "https://runcouriers.com#capability-health",
      "operationId": "getPublicHealth",
      "method": "GET",
      "path": "/api/health",
      "url": "https://runcouriers.com/api/health",
      "effect": "read",
      "description": "Read anonymous readiness and maintenance status without operational records or credentials.",
      "consentRequired": false,
      "requiresKnownReference": false
    },
    {
      "id": "https://runcouriers.com#capability-assessment",
      "operationId": "submitInquiry",
      "method": "POST",
      "path": "/api/inquiry",
      "limit": 5,
      "windowSeconds": 600,
      "url": "https://runcouriers.com/api/inquiry",
      "effect": "store-enquiry",
      "description": "Request a route assessment with affirmative consent. This does not book, accept, or dispatch a shipment.",
      "consentRequired": true,
      "requiresKnownReference": false,
      "requiredConsents": [
        "consentContact",
        "consentTerms"
      ],
      "serviceTypes": [
        "delivery",
        "route"
      ],
      "availability": {
        "state": "disabled",
        "intakeConfigured": false,
        "readinessUrl": "https://runcouriers.com/api/health",
        "serverEnforced": true,
        "note": "This reports the environment switch only, not live readiness. Check health; the server can reject a request even when configured."
      }
    }
  ],
  "constraints": [
    "Only public HTTP operations are documented; permission-protected dispatch interfaces are outside this document.",
    "No booking, payment, contract acceptance, or external communications action is available through this convention.",
    "Consent must be supplied by the person concerned; reading this document does not grant consent or authority."
  ]
}