> ## Documentation Index
> Fetch the complete documentation index at: https://uqp.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# UQP peer discovery

> Neutral reference discovery for UQP definitions and optional provider routing hints.

Source: spec/schemas/discovery.json. Draft v0.1; reference, not production.

Neutral reference discovery for UQP definitions and optional provider routing hints.

## Properties and definitions

| Property / definition | Required | Type / reference | Description / constraints |
| - | - | - | - |
| protocol | yes | see JSON | \{"const":"uqp"} |
| spec\_version | yes | string | \{"type":"string","pattern":"^\[0-9]+\\.\[0-9]+\\.\[0-9]+\$"} |
| endpoints | yes | object | \{"type":"object","properties":\{"rest":\{"type":"string","format":"uri"},"mcp":\{"type":"string","format":"uri"},"graphql":\{"type":"string","format":"uri"}},"minProperties":1,"additionalProperties":false} |
| supported\_packs | yes | array | \{"type":"array","items":\{"type":"object","properties":\{"pack\_id":\{"type":"string","minLength":1},"pack\_version":\{"type":"string","minLength":1}},"required":\["pack\_id","pack\_version"],"additionalProperties":false}} |
| routing\_policy | yes | common.json#/\$defs/routingPolicy | \{"\$ref":"common.json#/\$defs/routingPolicy"} |
| checkout\_handoffs | yes | array | \{"type":"array","items":\{"enum":\["ucp","acp"]},"uniqueItems":true} |
| documentation\_url | yes | string | \{"type":"string","format":"uri"} |
| review\_sla\_seconds | no | integer | \{"type":"integer","minimum":1} |
| notes | no | string | \{"type":"string"} |
| keys | no | array | \{"type":"array","items":\{"\$ref":"#/\$defs/publicJwk"}} |

## Full JSON

```json theme={null}
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://uqp.dev/spec/schemas/discovery.json",
  "title": "UQP peer discovery",
  "description": "Neutral reference discovery for UQP definitions and optional provider routing hints.",
  "type": "object",
  "properties": {
    "protocol": {
      "const": "uqp"
    },
    "spec_version": {
      "type": "string",
      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
    },
    "endpoints": {
      "type": "object",
      "properties": {
        "rest": {
          "type": "string",
          "format": "uri"
        },
        "mcp": {
          "type": "string",
          "format": "uri"
        },
        "graphql": {
          "type": "string",
          "format": "uri"
        }
      },
      "minProperties": 1,
      "additionalProperties": false
    },
    "supported_packs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "pack_id": {
            "type": "string",
            "minLength": 1
          },
          "pack_version": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "pack_id",
          "pack_version"
        ],
        "additionalProperties": false
      }
    },
    "routing_policy": {
      "$ref": "common.json#/$defs/routingPolicy"
    },
    "checkout_handoffs": {
      "type": "array",
      "items": {
        "enum": [
          "ucp",
          "acp"
        ]
      },
      "uniqueItems": true
    },
    "documentation_url": {
      "type": "string",
      "format": "uri"
    },
    "review_sla_seconds": {
      "type": "integer",
      "minimum": 1
    },
    "notes": {
      "type": "string"
    },
    "keys": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/publicJwk"
      }
    }
  },
  "required": [
    "protocol",
    "spec_version",
    "endpoints",
    "supported_packs",
    "routing_policy",
    "checkout_handoffs",
    "documentation_url"
  ],
  "additionalProperties": false,
  "$defs": {
    "publicJwk": {
      "type": "object",
      "properties": {
        "kty": {
          "enum": [
            "OKP",
            "EC"
          ]
        },
        "kid": {
          "type": "string",
          "minLength": 1
        },
        "use": {
          "const": "sig"
        },
        "alg": {
          "enum": [
            "EdDSA",
            "ES256"
          ]
        },
        "crv": {
          "enum": [
            "Ed25519",
            "P-256"
          ]
        },
        "x": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$"
        },
        "y": {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]{43}$"
        }
      },
      "required": [
        "kty",
        "kid",
        "alg",
        "crv",
        "x"
      ],
      "additionalProperties": false,
      "oneOf": [
        {
          "properties": {
            "kty": {
              "const": "OKP"
            },
            "alg": {
              "const": "EdDSA"
            },
            "crv": {
              "const": "Ed25519"
            }
          },
          "not": {
            "required": [
              "y"
            ],
            "properties": {
              "y": {}
            }
          }
        },
        {
          "properties": {
            "kty": {
              "const": "EC"
            },
            "alg": {
              "const": "ES256"
            },
            "crv": {
              "const": "P-256"
            },
            "y": {}
          },
          "required": [
            "y"
          ]
        }
      ]
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.