{ "mcpSpec": "0.3.2", "mcpVersion": "2026-07-28", "mcpVersions": [ "2026-07-28", "2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05" ], "server": { "name": "sourcey", "title": "Sourcey", "version": "1.2.2", "description": "Find evidence-backed startup offers and Agent Readiness report cards in Sourcey's immutable Catalog.", "icons": [ { "src": "https://sourcey.com/brand/sourcey-mark.png", "mimeType": "image/png", "sizes": [ "250x250" ] } ], "websiteUrl": "https://sourcey.com" }, "description": "Sourcey MCP finds and compares current startup credits, discounts, free tiers, and deals using typed company facts, explicit eligibility unknowns, exact evidence, and a signed change stream. It also prepares canonical Agent Readiness declarations for vendor APIs, SaaS services, authentication, payment, provisioning, operation, recovery, and agent standards without assigning readiness results. It never applies for or redeems an offer.", "capabilities": { "tools": { "listChanged": false } }, "transport": { "type": "streamable-http", "url": "https://mcp.sourcey.com/mcp" }, "tools": [ { "name": "search_offers", "title": "Search credits and deals", "description": "Search current startup credits and deals, including cloud credits, SaaS discounts, free tiers, grants, perks, and partner offers. Filter by query, vendor, or category and evaluate eligibility from typed company facts; unknowns remain explicit.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Natural-language search for a startup need, technology, credit, discount, free tier, perk, grant, or deal." }, "entities": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "Current Entity slugs or immutable Entity IDs to include." }, "categories": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "Catalog categories to include, such as hosting, databases, or observability." }, "facts": { "type": "object", "propertyNames": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "additionalProperties": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "null" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "boolean" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "string-set" }, "values": { "type": "array", "items": { "type": "string" } } }, "required": [ "type", "values" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number-set" }, "values": { "type": "array", "items": { "type": "number" } } }, "required": [ "type", "values" ], "additionalProperties": false } ] }, "description": "Known typed company facts used only for explicit eligibility evaluation; omit unknown facts." }, "limit": { "type": "integer", "minimum": 1, "maximum": 25, "description": "Maximum results to return; defaults to 10." } }, "required": [ "facts" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "object", "properties": { "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1 }, "category": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "identity_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "verified" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "verified_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "identity_epoch_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "verified_at", "identity_epoch_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "entity_id", "slug", "name", "category", "revision_digest" ], "additionalProperties": false }, "program": { "type": "object", "properties": { "program_id": { "type": "string", "pattern": "^prg_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "title": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1, "maxLength": 240 }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "program_id", "slug", "title", "revision_digest" ], "additionalProperties": false }, "offer": { "type": "object", "properties": { "offer_id": { "type": "string", "pattern": "^off_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "title": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1, "maxLength": 240 }, "economics": { "type": "object", "properties": { "consideration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "fixed" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "variable" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "kind", "description" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "unknown" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "kind", "description" ], "additionalProperties": false } ] }, "benefits": { "minItems": 1, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "credit" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false }, "maximum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "minimum", "maximum" ], "additionalProperties": false } ] }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "discount" }, "percentage": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maximum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "minimum_basis_points", "maximum_basis_points" ], "additionalProperties": false } ] }, "applies_to": { "type": "string", "minLength": 1, "maxLength": 240 }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "percentage" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "cashback" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "money" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false }, "maximum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "minimum", "maximum" ], "additionalProperties": false } ] } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "percentage" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maximum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "minimum_basis_points", "maximum_basis_points" ], "additionalProperties": false } ] } }, "required": [ "kind", "value" ], "additionalProperties": false } ] }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "waiver" }, "waived_item": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "benefit_id", "description", "kind", "waived_item" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "free-service" }, "service": { "type": "string", "minLength": 1, "maxLength": 240 }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "service" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "other" } }, "required": [ "benefit_id", "description", "kind" ], "additionalProperties": false } ] } } }, "required": [ "consideration", "benefits" ], "additionalProperties": false }, "eligibility": { "type": "object", "properties": { "rule": { "$ref": "#/definitions/__schema0" } }, "required": [ "rule" ], "additionalProperties": false }, "access": { "type": "object", "properties": { "availability": { "type": "string", "enum": [ "public", "referral", "membership", "invite", "automatic", "other" ] }, "method": { "type": "string", "enum": [ "form", "code", "contact", "automatic", "other" ] }, "url": { "type": "string", "format": "uri" }, "public_code": { "type": "string", "minLength": 1, "maxLength": 200 }, "instructions": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "availability", "method" ], "additionalProperties": false }, "lifecycle": { "type": "string", "enum": [ "active", "ended", "withdrawn" ] }, "effective_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "effective_until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "terms_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "checked" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "checked_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "checked_at", "revision_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "offer_id", "slug", "title", "summary", "economics", "eligibility", "access", "lifecycle", "effective_from", "revision_digest" ], "additionalProperties": false }, "eligibility": { "type": "object", "properties": { "eligible": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "trace": { "$ref": "#/definitions/__schema1" } }, "required": [ "eligible", "trace" ], "additionalProperties": false }, "unresolved": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "fact_unknown" }, "criterion_id": { "type": "string", "minLength": 1 }, "statement": { "type": "string", "minLength": 1 }, "fact": { "type": "string", "minLength": 1 } }, "required": [ "kind", "criterion_id", "statement", "fact" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "manual_review" }, "criterion_id": { "type": "string", "minLength": 1 }, "statement": { "type": "string", "minLength": 1 } }, "required": [ "kind", "criterion_id", "statement" ], "additionalProperties": false } ] } }, "evidence": { "type": "object", "properties": { "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "basis_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "vendor_attestation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "none" } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "current" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "attested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "event_id", "attested_at" ], "additionalProperties": false } ] } }, "required": [ "freshness", "dispute", "basis_event_ids", "vendor_attestation" ], "additionalProperties": false }, "canonical_url": { "type": "string", "format": "uri" } }, "required": [ "entity", "offer", "eligibility", "unresolved", "evidence", "canonical_url" ], "additionalProperties": false } } }, "required": [ "release_id", "total", "truncated", "data" ], "additionalProperties": false, "definitions": { "__schema0": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "present", "absent" ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "eq", "neq", "contains" ] }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "boolean" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "const": "in" }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "string-set" }, "values": { "minItems": 1, "type": "array", "items": { "type": "string" } } }, "required": [ "type", "values" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number-set" }, "values": { "minItems": 1, "type": "array", "items": { "type": "number" } } }, "required": [ "type", "values" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "lt", "lte", "gt", "gte" ] }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "manual" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "reason": { "type": "string", "enum": [ "vendor-discretion", "external-verification", "not-machine-evaluable", "other" ] } }, "required": [ "kind", "criterion_id", "statement", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "constant" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "value": { "type": "boolean" } }, "required": [ "kind", "criterion_id", "statement", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "all" }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema0" } } }, "required": [ "kind", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "any" }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema0" } } }, "required": [ "kind", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "not" }, "rule": { "$ref": "#/definitions/__schema0" } }, "required": [ "kind", "rule" ], "additionalProperties": false } ] }, "__schema1": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "all", "any" ] }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema1" } } }, "required": [ "kind", "outcome", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "not" }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] }, "rule": { "$ref": "#/definitions/__schema1" } }, "required": [ "kind", "outcome", "rule" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "predicate", "manual", "constant" ] }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] } }, "required": [ "kind", "criterion_id", "statement", "outcome" ], "additionalProperties": false } ] } } }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "compare_offers", "title": "Compare offers", "description": "Compare two to ten startup credit or deal offers side by side, including value, access requirements, eligibility, freshness, and evidence. Unknown eligibility and unsupported stacking remain explicit.", "inputSchema": { "type": "object", "properties": { "offers": { "minItems": 2, "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "string", "minLength": 1, "description": "Current Entity slug or immutable Entity ID." }, "offer": { "type": "string", "minLength": 1, "description": "Current offer slug." } }, "required": [ "entity", "offer" ], "additionalProperties": false }, "description": "Two to ten exact startup credit or deal offers to compare in this order." }, "facts": { "type": "object", "propertyNames": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "additionalProperties": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "null" } }, "required": [ "type" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "boolean" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "string-set" }, "values": { "type": "array", "items": { "type": "string" } } }, "required": [ "type", "values" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number-set" }, "values": { "type": "array", "items": { "type": "number" } } }, "required": [ "type", "values" ], "additionalProperties": false } ] }, "description": "Known typed company facts used only for explicit eligibility evaluation; omit unknown facts." } }, "required": [ "offers", "facts" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "data": { "minItems": 2, "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "object", "properties": { "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1 }, "category": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "identity_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "verified" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "verified_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "identity_epoch_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "verified_at", "identity_epoch_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "entity_id", "slug", "name", "category", "revision_digest" ], "additionalProperties": false }, "program": { "type": "object", "properties": { "program_id": { "type": "string", "pattern": "^prg_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "title": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1, "maxLength": 240 }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "program_id", "slug", "title", "revision_digest" ], "additionalProperties": false }, "offer": { "type": "object", "properties": { "offer_id": { "type": "string", "pattern": "^off_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "title": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1, "maxLength": 240 }, "economics": { "type": "object", "properties": { "consideration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "none" } }, "required": [ "kind" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "fixed" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "variable" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "kind", "description" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "unknown" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "kind", "description" ], "additionalProperties": false } ] }, "benefits": { "minItems": 1, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "credit" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false }, "maximum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "minimum", "maximum" ], "additionalProperties": false } ] }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "discount" }, "percentage": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maximum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "minimum_basis_points", "maximum_basis_points" ], "additionalProperties": false } ] }, "applies_to": { "type": "string", "minLength": 1, "maxLength": 240 }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "percentage" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "cashback" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "money" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "amount" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false }, "maximum": { "type": "object", "properties": { "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "minor_units": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false } }, "required": [ "kind", "minimum", "maximum" ], "additionalProperties": false } ] } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "percentage" }, "value": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "basis_points" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "range" }, "minimum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 }, "maximum_basis_points": { "type": "integer", "minimum": 1, "maximum": 10000 } }, "required": [ "kind", "minimum_basis_points", "maximum_basis_points" ], "additionalProperties": false } ] } }, "required": [ "kind", "value" ], "additionalProperties": false } ] }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "waiver" }, "waived_item": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "benefit_id", "description", "kind", "waived_item" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "free-service" }, "service": { "type": "string", "minLength": 1, "maxLength": 240 }, "duration": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "exact" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "up-to" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "at-least" }, "value": { "type": "string", "pattern": "^P(?=\\d|T\\d)(?:\\d+Y)?(?:\\d+M)?(?:\\d+D)?(?:T(?:\\d+H)?(?:\\d+M)?(?:\\d+S)?)?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] } }, "required": [ "benefit_id", "description", "kind", "service" ], "additionalProperties": false }, { "type": "object", "properties": { "benefit_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "description": { "type": "string", "minLength": 1, "maxLength": 500 }, "kind": { "type": "string", "const": "other" } }, "required": [ "benefit_id", "description", "kind" ], "additionalProperties": false } ] } } }, "required": [ "consideration", "benefits" ], "additionalProperties": false }, "eligibility": { "type": "object", "properties": { "rule": { "$ref": "#/definitions/__schema0" } }, "required": [ "rule" ], "additionalProperties": false }, "access": { "type": "object", "properties": { "availability": { "type": "string", "enum": [ "public", "referral", "membership", "invite", "automatic", "other" ] }, "method": { "type": "string", "enum": [ "form", "code", "contact", "automatic", "other" ] }, "url": { "type": "string", "format": "uri" }, "public_code": { "type": "string", "minLength": 1, "maxLength": 200 }, "instructions": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "availability", "method" ], "additionalProperties": false }, "lifecycle": { "type": "string", "enum": [ "active", "ended", "withdrawn" ] }, "effective_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "effective_until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "terms_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "checked" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "checked_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "checked_at", "revision_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "offer_id", "slug", "title", "summary", "economics", "eligibility", "access", "lifecycle", "effective_from", "revision_digest" ], "additionalProperties": false }, "eligibility": { "type": "object", "properties": { "eligible": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "trace": { "$ref": "#/definitions/__schema1" } }, "required": [ "eligible", "trace" ], "additionalProperties": false }, "unresolved": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "fact_unknown" }, "criterion_id": { "type": "string", "minLength": 1 }, "statement": { "type": "string", "minLength": 1 }, "fact": { "type": "string", "minLength": 1 } }, "required": [ "kind", "criterion_id", "statement", "fact" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "manual_review" }, "criterion_id": { "type": "string", "minLength": 1 }, "statement": { "type": "string", "minLength": 1 } }, "required": [ "kind", "criterion_id", "statement" ], "additionalProperties": false } ] } }, "evidence": { "type": "object", "properties": { "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "basis_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "vendor_attestation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "none" } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "current" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "attested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "event_id", "attested_at" ], "additionalProperties": false } ] } }, "required": [ "freshness", "dispute", "basis_event_ids", "vendor_attestation" ], "additionalProperties": false }, "canonical_url": { "type": "string", "format": "uri" } }, "required": [ "entity", "offer", "eligibility", "unresolved", "evidence", "canonical_url" ], "additionalProperties": false } }, "stacking": { "type": "object", "properties": { "outcome": { "type": "string", "const": "not_evaluated" }, "reason": { "type": "string", "const": "The Sourcey catalog does not carry pairwise stacking evidence." } }, "required": [ "outcome", "reason" ], "additionalProperties": false } }, "required": [ "release_id", "data", "stacking" ], "additionalProperties": false, "definitions": { "__schema0": { "anyOf": [ { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "present", "absent" ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "eq", "neq", "contains" ] }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "string" }, "value": { "type": "string" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "boolean" }, "value": { "type": "boolean" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "const": "in" }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "string-set" }, "values": { "minItems": 1, "type": "array", "items": { "type": "string" } } }, "required": [ "type", "values" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "number-set" }, "values": { "minItems": 1, "type": "array", "items": { "type": "number" } } }, "required": [ "type", "values" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "predicate" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "fact": { "type": "string", "pattern": "^[a-z][a-z0-9_-]*(?:\\.[a-z][a-z0-9_-]*)+$" }, "operator": { "type": "string", "enum": [ "lt", "lte", "gt", "gte" ] }, "value": { "oneOf": [ { "type": "object", "properties": { "type": { "type": "string", "const": "number" }, "value": { "type": "number" } }, "required": [ "type", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "date" }, "value": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "type", "value" ], "additionalProperties": false } ] } }, "required": [ "kind", "criterion_id", "statement", "fact", "operator", "value" ], "additionalProperties": false } ] }, { "type": "object", "properties": { "kind": { "type": "string", "const": "manual" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "reason": { "type": "string", "enum": [ "vendor-discretion", "external-verification", "not-machine-evaluable", "other" ] } }, "required": [ "kind", "criterion_id", "statement", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "constant" }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "value": { "type": "boolean" } }, "required": [ "kind", "criterion_id", "statement", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "all" }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema0" } } }, "required": [ "kind", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "any" }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema0" } } }, "required": [ "kind", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "not" }, "rule": { "$ref": "#/definitions/__schema0" } }, "required": [ "kind", "rule" ], "additionalProperties": false } ] }, "__schema1": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "all", "any" ] }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] }, "rules": { "minItems": 1, "type": "array", "items": { "$ref": "#/definitions/__schema1" } } }, "required": [ "kind", "outcome", "rules" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "not" }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] }, "rule": { "$ref": "#/definitions/__schema1" } }, "required": [ "kind", "outcome", "rule" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "predicate", "manual", "constant" ] }, "criterion_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "statement": { "type": "string", "minLength": 1, "maxLength": 500 }, "outcome": { "type": "string", "enum": [ "met", "unmet", "unknown" ] } }, "required": [ "kind", "criterion_id", "statement", "outcome" ], "additionalProperties": false } ] } } }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "inspect_evidence", "title": "Inspect evidence", "description": "Inspect the provenance behind startup credits and deals. Resolve one to ten exact revisions to supporting events and observations, including freshness and dispute status.", "inputSchema": { "type": "object", "properties": { "revision_digests": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "description": "Exact offer revision digests returned by Sourcey search or comparison." } }, "required": [ "revision_digests" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "data": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "object", "properties": { "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "first_inclusion_sequence": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "observation_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "freshness_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "revision_digest", "first_inclusion_sequence", "event_ids", "observation_ids", "coverage_policy_digest", "freshness_policy_digest" ], "additionalProperties": false } } }, "required": [ "release_id", "data" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_changes", "title": "Get changes", "description": "Track added, changed, withdrawn, and removed startup credits, discounts, free tiers, perks, and deals through Sourcey's signed change feed after an optional cursor.", "inputSchema": { "type": "object", "properties": { "cursor": { "type": "string", "minLength": 1, "description": "Opaque signed cursor returned by the previous change-feed page." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "feed_contract": { "type": "string", "const": "sourcey.catalog-feed/v1alpha1" }, "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "snapshot_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "diff_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "retained_from_release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "data": { "type": "array", "items": { "type": "object", "properties": { "change_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "kind": { "type": "string", "pattern": "^[a-z][a-z0-9-]*(?:\\.[a-z][a-z0-9-]*)+$", "description": "Append-only release change kind. Known values are examples; new kinds may appear within public API v1.", "examples": [ "entity.added", "entity.updated", "entity.retired", "program.added", "program.updated", "program.retired", "offer.added", "offer.updated", "offer.ended", "offer.retired", "offer.withdrawn", "policy.added", "policy.updated", "policy.retired", "agent-readiness.added", "agent-readiness.updated", "agent-readiness.regraded", "agent-readiness.relocated", "agent-readiness.ended", "agent-readiness.withdrawn", "asset.bound", "asset.updated", "asset.withdrawn" ], "x-sourcey-extensible-enum": true }, "subject_type": { "type": "string", "enum": [ "entity", "program", "offer", "policy", "agent_readiness_profile", "asset_binding" ] }, "subject_id": { "anyOf": [ { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } ] }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "previous_revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "projection_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "previous_projection_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "basis_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "tombstone": { "type": "object", "properties": { "reason": { "type": "string", "enum": [ "retired", "ended", "withdrawn" ] }, "canonical_route": { "type": "string", "pattern": "^\\/.*" } }, "required": [ "reason" ], "additionalProperties": false } }, "required": [ "change_id", "kind", "subject_type", "subject_id", "basis_event_ids" ], "additionalProperties": false } }, "next_cursor": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] } }, "required": [ "feed_contract", "release_id", "snapshot_id", "diff_digest", "retained_from_release_id", "data", "next_cursor" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "search_readiness", "title": "Search Agent Readiness", "description": "Search published Agent Readiness report cards for APIs, SaaS products, authentication, payments, provisioning, operations, and recovery. Returns the overall A+ to F grade, five-stage outcomes, evidence coverage, freshness, primary blocker, remediation context, and canonical report URL without conflating service readiness with startup-credit eligibility.", "inputSchema": { "type": "object", "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Vendor, service, API, product, capability, blocker, or readiness need." }, "entity": { "type": "string", "minLength": 1, "description": "Current Sourcey Entity slug or immutable Entity ID." }, "product": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "description": "Exact Agent Readiness product key." }, "funnel": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$", "description": "Exact Agent Readiness service-use funnel key." }, "grade": { "type": "string", "enum": [ "A+", "A", "B+", "B", "C+", "C", "D", "F", "unrated" ], "description": "Exact published report-card grade." }, "limit": { "type": "integer", "minimum": 1, "maximum": 25, "description": "Maximum results to return; defaults to 10." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "data": { "type": "array", "items": { "type": "object", "properties": { "entity": { "type": "object", "properties": { "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1 }, "category": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "identity_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "verified" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "verified_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "identity_epoch_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "verified_at", "identity_epoch_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "entity_id", "slug", "name", "category", "revision_digest" ], "additionalProperties": false }, "profile": { "type": "object", "properties": { "agent_readiness_profile_id": { "type": "string", "pattern": "^arp_[0-9a-hjkmnp-tv-z]{26}$" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "scope": { "type": "object", "properties": { "product": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false }, "funnel": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false } }, "required": [ "product", "funnel" ], "additionalProperties": false }, "declaration_revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "lifecycle": { "type": "string", "enum": [ "active", "ended", "withdrawn" ] }, "effective_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "policy_version": { "type": "string", "minLength": 1 }, "policy_as_of": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "overall_outcome": { "type": "string", "enum": [ "pass", "constrained", "fail", "unknown", "not_applicable" ] }, "public_state": { "type": "string", "enum": [ "ready", "limited", "blocked", "unknown", "not_applicable" ] }, "state_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "grade": { "type": "string", "enum": [ "A+", "A", "B+", "B", "C+", "C", "D", "F", "unrated" ] }, "grade_derivation": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 }, "coverage_rule": { "type": "string", "minLength": 1, "maxLength": 280 }, "outcome_rule": { "type": "string", "minLength": 1, "maxLength": 280 } }, "required": [ "label", "explanation", "coverage_rule", "outcome_rule" ], "additionalProperties": false }, "publication": { "type": "object", "properties": { "visibility": { "type": "string", "enum": [ "discoverable", "resolvable_only", "private" ] }, "reasons": { "type": "array", "items": { "type": "string", "enum": [ "lifecycle_not_active", "coverage_incomplete", "required_evidence_not_supported", "freshness_not_fresh", "unrated", "no_useful_finding", "open_dispute" ] } } }, "required": [ "visibility", "reasons" ], "additionalProperties": false }, "primary_finding": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "public_state": { "type": "string", "enum": [ "limited", "blocked" ] }, "finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false }, "blocker": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "explanation" ], "additionalProperties": false } }, "required": [ "stage", "stage_label", "public_state", "finding" ], "additionalProperties": false }, "coverage": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "complete", "incomplete" ] }, "required_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "covered_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ratio": { "type": "number", "minimum": 0, "maximum": 1 }, "barrier_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "verified_barrier_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "barrier_ratio": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "status", "required_signals", "covered_signals", "ratio", "barrier_signals", "verified_barrier_signals", "barrier_ratio" ], "additionalProperties": false }, "last_tested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "canonical_url": { "type": "string", "format": "uri" }, "projection_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "stages": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "outcome": { "type": "string", "enum": [ "pass", "constrained", "fail", "unknown", "not_applicable" ] }, "public_state": { "type": "string", "enum": [ "ready", "limited", "blocked", "unknown", "not_applicable" ] }, "state_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "primary_finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false } }, "required": [ "stage", "stage_label", "outcome", "public_state", "state_label", "primary_finding" ], "additionalProperties": false } }, "provenance": { "type": "object", "properties": { "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "vendor_attestation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "none" } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "current" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "attested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "event_id", "attested_at" ], "additionalProperties": false } ] } }, "required": [ "freshness", "dispute", "vendor_attestation" ], "additionalProperties": false } }, "required": [ "agent_readiness_profile_id", "entity_id", "scope", "declaration_revision_digest", "lifecycle", "effective_from", "revision_digest", "policy_digest", "policy_version", "policy_as_of", "overall_outcome", "public_state", "state_label", "grade", "grade_derivation", "publication", "coverage", "last_tested_at", "freshness", "canonical_url", "projection_digest", "stages", "provenance" ], "additionalProperties": false } }, "required": [ "entity", "profile" ], "additionalProperties": false } } }, "required": [ "release_id", "total", "truncated", "data" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_readiness", "title": "Get an Agent Readiness report card", "description": "Get one exact published Agent Readiness report card with its visible A+ to F grade, five service-use stages, individual findings, blockers, remediations, tested surfaces, methods, evidence state, coverage, freshness, policy identity, provenance, and canonical URL. Resolve by immutable profile ID or by one Entity plus exact product and funnel.", "inputSchema": { "anyOf": [ { "type": "object", "properties": { "profile_id": { "type": "string", "pattern": "^arp_[0-9a-hjkmnp-tv-z]{26}$" } }, "required": [ "profile_id" ], "additionalProperties": false }, { "type": "object", "properties": { "entity": { "type": "string", "minLength": 1, "description": "Current Sourcey Entity slug or immutable Entity ID." }, "product": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "funnel": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "entity", "product", "funnel" ], "additionalProperties": false } ] }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "data": { "type": "object", "properties": { "entity": { "type": "object", "properties": { "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1 }, "category": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "identity_assurance": { "type": "object", "properties": { "status": { "type": "string", "const": "verified" }, "assurance_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "verified_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "identity_epoch_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "method_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "status", "assurance_id", "verified_at", "identity_epoch_digest", "method_policy_digest", "coverage_policy_digest", "event_id", "receipt_digest" ], "additionalProperties": false } }, "required": [ "entity_id", "slug", "name", "category", "revision_digest" ], "additionalProperties": false }, "profile": { "type": "object", "properties": { "agent_readiness_profile_id": { "type": "string", "pattern": "^arp_[0-9a-hjkmnp-tv-z]{26}$" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "scope": { "type": "object", "properties": { "product": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false }, "funnel": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false } }, "required": [ "product", "funnel" ], "additionalProperties": false }, "lifecycle": { "type": "string", "enum": [ "active", "ended", "withdrawn" ] }, "effective_from": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "effective_until": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "policy_version": { "type": "string", "minLength": 1 }, "policy_as_of": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "assessment_basis": { "type": "object", "properties": { "principal": { "type": "string", "const": "authorized_human_or_organization" }, "initial_state": { "type": "object", "properties": { "product_specific_account": { "type": "boolean", "const": false }, "product_credentials": { "type": "boolean", "const": false }, "paid_subscription": { "type": "boolean", "const": false }, "provisioned_resource": { "type": "boolean", "const": false }, "external_identity": { "type": "string", "const": "only_when_declared_by_exact_funnel" } }, "required": [ "product_specific_account", "product_credentials", "paid_subscription", "provisioned_resource", "external_identity" ], "additionalProperties": false }, "permitted_human_boundaries": { "type": "array", "items": { "type": "string", "enum": [ "account_ownership_confirmation", "delegated_identity_consent", "regulated_approval", "final_payment_or_irreversible_commitment" ] } }, "required_handoff_properties": { "type": "array", "items": { "type": "string", "enum": [ "exact_disclosure", "resumable_handoff", "deterministic_continuation" ] } }, "forbidden_substitutions": { "type": "array", "items": { "type": "string", "enum": [ "captcha_solving", "human_password_or_session_sharing", "concealed_agent_identity", "invented_eligibility", "unbound_out_of_band_code", "vendor_policy_bypass", "unapproved_consequential_action" ] } }, "success": { "type": "object", "properties": { "target_coverage": { "type": "string", "const": "every_declared_target" }, "interface_coverage": { "type": "string", "const": "at_least_one_declared_alternative" }, "authority": { "type": "string", "const": "scoped" }, "failure_semantics": { "type": "string", "const": "documented" }, "recovery": { "type": "string", "const": "supported" } }, "required": [ "target_coverage", "interface_coverage", "authority", "failure_semantics", "recovery" ], "additionalProperties": false }, "observed_assessment": { "type": "object", "properties": { "allowed_sources": { "type": "array", "items": { "type": "string", "enum": [ "public_documentation", "public_metadata", "public_endpoints", "non_mutating_interaction", "operator_attested_public_observation" ] } }, "consequential_claims": { "type": "string", "const": "certification_required" } }, "required": [ "allowed_sources", "consequential_claims" ], "additionalProperties": false } }, "required": [ "principal", "initial_state", "permitted_human_boundaries", "required_handoff_properties", "forbidden_substitutions", "success", "observed_assessment" ], "additionalProperties": false }, "surface_catalog": { "type": "object", "properties": { "assessment_targets": { "type": "array", "items": { "type": "object", "properties": { "target_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "interface_ids": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } } }, "required": [ "target_id", "name", "interface_ids" ], "additionalProperties": false } }, "participants": { "type": "array", "items": { "type": "object", "properties": { "participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "subject", "access_operator", "identity_provider", "payment_provider", "provisioning_provider", "operations_provider" ] } }, "identity": { "anyOf": [ { "type": "object", "properties": { "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" } }, "required": [ "entity_id" ], "additionalProperties": false }, { "type": "object", "properties": { "origin_source_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" } }, "required": [ "origin_source_id" ], "additionalProperties": false } ] } }, "required": [ "participant_id", "roles", "identity" ], "additionalProperties": false } }, "resources": { "type": "array", "items": { "type": "object", "properties": { "resource_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "uri": { "type": "string", "format": "uri" }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "discovery", "terms", "eligibility", "pricing", "access", "checkout", "provisioning", "operations", "recovery", "authentication", "descriptor", "documentation", "policy", "status" ] } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } }, "allowed_redirect_hosts": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" } } }, "required": [ "resource_id", "uri", "roles", "operated_by_participant_id", "standard_bindings" ], "additionalProperties": false } }, "endpoints": { "type": "array", "items": { "type": "object", "properties": { "endpoint_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "uri": { "type": "string", "format": "uri" }, "transport": { "type": "string", "enum": [ "http", "websocket", "grpc" ] }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "service", "authorization", "token", "registration", "protected_resource", "checkout", "status", "recovery", "webhook" ] } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } }, "allowed_redirect_hosts": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" } } }, "required": [ "endpoint_id", "uri", "transport", "roles", "operated_by_participant_id", "standard_bindings" ], "additionalProperties": false } }, "interfaces": { "type": "array", "items": { "type": "object", "properties": { "interface_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "modality": { "type": "string", "enum": [ "web_application", "network_api", "command_line", "software_library", "tool_server", "agent_service" ] }, "functions": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "service_operation", "authentication", "commerce", "events", "recovery" ] } }, "endpoint_ids": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "resource_ids": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } } }, "required": [ "interface_id", "modality", "functions", "endpoint_ids", "resource_ids", "operated_by_participant_id", "standard_bindings" ], "additionalProperties": false } }, "relations": { "type": "array", "items": { "type": "object", "properties": { "relation_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "kind": { "type": "string", "enum": [ "describes", "authenticates", "requires", "alternative_to", "precedes" ] }, "from": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false }, "to": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false } }, "required": [ "relation_id", "kind", "from", "to" ], "additionalProperties": false } }, "surface_exclusions": { "type": "array", "items": { "type": "object", "properties": { "exclusion_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "role": { "type": "string", "enum": [ "discovery", "terms", "eligibility", "pricing", "access", "checkout", "provisioning", "operations", "recovery", "authentication", "descriptor", "documentation", "policy", "status" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": [ "exclusion_id", "role", "rationale" ], "additionalProperties": false } } }, "required": [ "assessment_targets", "participants", "resources", "endpoints", "interfaces", "relations", "surface_exclusions" ], "additionalProperties": false }, "overall_outcome": { "type": "string", "enum": [ "pass", "constrained", "fail", "unknown", "not_applicable" ] }, "public_state": { "type": "string", "enum": [ "ready", "limited", "blocked", "unknown", "not_applicable" ] }, "state_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "grade": { "type": "string", "enum": [ "A+", "A", "B+", "B", "C+", "C", "D", "F", "unrated" ] }, "grade_derivation": { "type": "object", "properties": { "label": { "type": "string", "minLength": 1, "maxLength": 80 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 }, "coverage_rule": { "type": "string", "minLength": 1, "maxLength": 280 }, "outcome_rule": { "type": "string", "minLength": 1, "maxLength": 280 } }, "required": [ "label", "explanation", "coverage_rule", "outcome_rule" ], "additionalProperties": false }, "publication": { "type": "object", "properties": { "visibility": { "type": "string", "enum": [ "discoverable", "resolvable_only", "private" ] }, "reasons": { "type": "array", "items": { "type": "string", "enum": [ "lifecycle_not_active", "coverage_incomplete", "required_evidence_not_supported", "freshness_not_fresh", "unrated", "no_useful_finding", "open_dispute" ] } } }, "required": [ "visibility", "reasons" ], "additionalProperties": false }, "primary_finding": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "public_state": { "type": "string", "enum": [ "limited", "blocked" ] }, "finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false }, "blocker": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "explanation" ], "additionalProperties": false } }, "required": [ "stage", "stage_label", "public_state", "finding" ], "additionalProperties": false }, "first_blocked_stage": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false }, "blocker": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "explanation" ], "additionalProperties": false } }, "required": [ "stage", "stage_label", "finding" ], "additionalProperties": false }, "limitations": { "type": "array", "items": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false }, "remediation": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "instruction": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "instruction" ], "additionalProperties": false } }, "required": [ "stage", "stage_label", "finding" ], "additionalProperties": false } }, "stages": { "minItems": 5, "maxItems": 5, "type": "array", "items": { "type": "object", "properties": { "stage": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] }, "stage_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "outcome": { "type": "string", "enum": [ "pass", "constrained", "fail", "unknown", "not_applicable" ] }, "public_state": { "type": "string", "enum": [ "ready", "limited", "blocked", "unknown", "not_applicable" ] }, "state_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "primary_finding": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false }, "secondary_context": { "type": "array", "items": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "context": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "condition", "finding" ], "additionalProperties": false } }, "signals": { "type": "array", "items": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "evaluation_role": { "type": "string", "enum": [ "graded", "barrier", "informational" ] }, "required": { "type": "boolean" }, "value": { "type": "string", "enum": [ "yes", "no", "partial", "unknown", "not_applicable" ] }, "value_label": { "type": "string", "minLength": 1, "maxLength": 40 }, "outcome": { "type": "string", "enum": [ "pass", "constrained", "fail", "unknown", "not_applicable" ] }, "public_state": { "type": "string", "enum": [ "ready", "limited", "blocked", "unknown", "not_applicable" ] }, "condition": { "type": "string", "minLength": 1, "maxLength": 160 }, "finding": { "type": "string", "minLength": 1, "maxLength": 280 }, "evidence_status": { "type": "string", "enum": [ "supported", "contradicted", "mixed", "missing" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "observed_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "tested_surfaces": { "type": "array", "items": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false } }, "assessment_method": { "type": "object", "properties": { "name": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "method_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "name", "version", "method_digest" ], "additionalProperties": false }, "determination_bases": { "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "direct_observation" }, "captures": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "retained_capture_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "capture_rung": { "type": "string", "enum": [ "http", "headless", "archive", "manual" ] } }, "required": [ "retained_capture_digest", "capture_rung" ], "additionalProperties": false } }, "artifact_digests": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "locators": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "artifact_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "start_byte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "end_byte": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "value_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "artifact_digest", "start_byte", "end_byte", "value_digest" ], "additionalProperties": false } } }, "required": [ "kind", "captures", "artifact_digests", "locators" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "bounded_absence" }, "captures": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "retained_capture_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "capture_rung": { "type": "string", "enum": [ "http", "headless", "archive", "manual" ] } }, "required": [ "retained_capture_digest", "capture_rung" ], "additionalProperties": false } }, "artifact_digests": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "coverage_scope": { "type": "string", "enum": [ "exact_resource", "tested_surfaces", "exact_funnel" ] }, "covered_surfaces": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false } }, "covered_branches": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "required": [ "kind", "captures", "artifact_digests", "coverage_scope", "covered_surfaces", "covered_branches" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "explicit_first_party_declaration" }, "captures": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "retained_capture_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "capture_rung": { "type": "string", "enum": [ "http", "headless", "archive", "manual" ] } }, "required": [ "retained_capture_digest", "capture_rung" ], "additionalProperties": false } }, "artifact_digests": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "source_surface": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false }, "locators": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "artifact_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "start_byte": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "end_byte": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 }, "value_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "artifact_digest", "start_byte", "end_byte", "value_digest" ], "additionalProperties": false } } }, "required": [ "kind", "captures", "artifact_digests", "source_surface", "locators" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "standard_requirement" }, "adapter_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "evidence_record_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "requirement": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "requirement_id": { "type": "string", "minLength": 1, "maxLength": 240 }, "relation": { "type": "string", "enum": [ "tests", "informational-reference" ] } }, "required": [ "namespace", "version", "requirement_id", "relation" ], "additionalProperties": false }, "artifact_digests": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "kind", "adapter_digest", "evidence_record_digest", "requirement", "artifact_digests" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "certification_receipt" }, "certification_receipt_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "kind", "certification_receipt_digest" ], "additionalProperties": false } ] } }, "note": { "type": "string", "minLength": 1, "maxLength": 500 }, "blocker": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "explanation" ], "additionalProperties": false }, "remediation": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "instruction": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "instruction" ], "additionalProperties": false } }, "required": [ "signal_code", "evaluation_role", "required", "value", "value_label", "outcome", "public_state", "condition", "finding", "evidence_status", "freshness", "tested_surfaces", "determination_bases" ], "additionalProperties": false } }, "blockers": { "type": "array", "items": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "explanation": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "explanation" ], "additionalProperties": false } }, "remediations": { "type": "array", "items": { "type": "object", "properties": { "signal_code": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "code": { "type": "string", "minLength": 1, "maxLength": 160 }, "instruction": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "signal_code", "code", "instruction" ], "additionalProperties": false } } }, "required": [ "stage", "stage_label", "outcome", "public_state", "state_label", "primary_finding", "secondary_context", "signals", "blockers", "remediations" ], "additionalProperties": false } }, "coverage": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "complete", "incomplete" ] }, "required_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "covered_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "ratio": { "type": "number", "minimum": 0, "maximum": 1 }, "barrier_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "verified_barrier_signals": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "barrier_ratio": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "status", "required_signals", "covered_signals", "ratio", "barrier_signals", "verified_barrier_signals", "barrier_ratio" ], "additionalProperties": false }, "last_tested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "provenance": { "type": "object", "properties": { "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "coverage_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "freshness_policy_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "basis_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "fields": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "pattern": "^\\/.*" }, "supporting_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "contradicting_event_ids": { "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "accepted_proof_kinds": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "observed", "derived", "editorial", "attested" ] } }, "evidence_proof_kinds": { "type": "array", "items": { "type": "string", "enum": [ "observed", "derived", "editorial", "attested" ] } }, "latest_observation_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] } }, "required": [ "path", "supporting_event_ids", "contradicting_event_ids", "accepted_proof_kinds", "evidence_proof_kinds", "freshness" ], "additionalProperties": false } }, "vendor_attestation": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "none" } }, "required": [ "status" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "current" }, "event_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "attested_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "status", "event_id", "attested_at" ], "additionalProperties": false } ] } }, "required": [ "freshness", "dispute", "coverage_policy_digest", "freshness_policy_digest", "basis_event_ids", "fields", "vendor_attestation" ], "additionalProperties": false }, "canonical_url": { "type": "string", "format": "uri" }, "projection_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "agent_readiness_profile_id", "entity_id", "scope", "lifecycle", "effective_from", "revision_digest", "policy_digest", "policy_version", "policy_as_of", "assessment_basis", "surface_catalog", "overall_outcome", "public_state", "state_label", "grade", "grade_derivation", "publication", "limitations", "stages", "coverage", "last_tested_at", "freshness", "provenance", "canonical_url", "projection_digest" ], "additionalProperties": false } }, "required": [ "entity", "profile" ], "additionalProperties": false } }, "required": [ "release_id", "data" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "prepare_declaration", "title": "Prepare an Agent Readiness declaration", "description": "Prepare canonical GitHub-ready YAML for an independent Agent Readiness assessment of one vendor product, API, SaaS service, authentication path, payment path, provisioning flow, operating interface, recovery flow, and exact agent standard. Resolves only exact Sourcey Entity identity, never assigns a grade or treats startup credits and deals as service readiness, and returns precise missing fields when the service graph is incomplete.", "inputSchema": { "type": "object", "properties": { "command_contract": { "type": "string", "const": "sourcey.agent-readiness-declaration-draft/v1alpha1" }, "subject": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "entity_id" }, "value": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "slug" }, "value": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "kind", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "domain" }, "value": { "type": "string", "pattern": "^(?=.{1,253}$)(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" } }, "required": [ "kind", "value" ], "additionalProperties": false } ] }, "scope": { "type": "object", "properties": { "product": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false }, "funnel": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false } }, "required": [ "product", "funnel" ], "additionalProperties": false }, "scope_source_uris": { "default": [], "type": "array", "items": { "type": "string", "format": "uri" } }, "subject_roles": { "default": [], "type": "array", "items": { "type": "string", "enum": [ "access_operator", "identity_provider", "payment_provider", "provisioning_provider", "operations_provider" ] } }, "assessment_targets": { "default": [], "type": "array", "items": { "type": "object", "properties": { "target_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 240 }, "interface_ids": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "target_id", "name", "interface_ids", "source_uris" ], "additionalProperties": false } }, "participants": { "default": [], "type": "array", "items": { "type": "object", "properties": { "participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "access_operator", "identity_provider", "payment_provider", "provisioning_provider", "operations_provider" ] } }, "identity": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "entity_id" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" } }, "required": [ "kind", "entity_id" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "origin_uri" }, "uri": { "type": "string", "format": "uri" } }, "required": [ "kind", "uri" ], "additionalProperties": false } ] }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "participant_id", "roles", "identity", "source_uris" ], "additionalProperties": false } }, "resources": { "default": [], "type": "array", "items": { "type": "object", "properties": { "resource_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "uri": { "type": "string", "format": "uri" }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "discovery", "terms", "eligibility", "pricing", "access", "checkout", "provisioning", "operations", "recovery", "authentication", "descriptor", "documentation", "policy", "status" ] } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } }, "allowed_redirect_hosts": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" } }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "resource_id", "uri", "roles", "operated_by_participant_id", "standard_bindings", "source_uris" ], "additionalProperties": false } }, "endpoints": { "default": [], "type": "array", "items": { "type": "object", "properties": { "endpoint_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "uri": { "type": "string", "format": "uri" }, "transport": { "type": "string", "enum": [ "http", "websocket", "grpc" ] }, "roles": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "service", "authorization", "token", "registration", "protected_resource", "checkout", "status", "recovery", "webhook" ] } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } }, "allowed_redirect_hosts": { "maxItems": 16, "type": "array", "items": { "type": "string", "maxLength": 253, "pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" } }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "endpoint_id", "uri", "transport", "roles", "operated_by_participant_id", "standard_bindings", "source_uris" ], "additionalProperties": false } }, "interfaces": { "default": [], "type": "array", "items": { "type": "object", "properties": { "interface_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "modality": { "type": "string", "enum": [ "web_application", "network_api", "command_line", "software_library", "tool_server", "agent_service" ] }, "functions": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "service_operation", "authentication", "commerce", "events", "recovery" ] } }, "endpoint_ids": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "resource_ids": { "type": "array", "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "operated_by_participant_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "standard_bindings": { "type": "array", "items": { "type": "object", "properties": { "namespace": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "relation": { "type": "string", "enum": [ "declares", "describes", "implements", "uses" ] } }, "required": [ "namespace", "version", "relation" ], "additionalProperties": false } }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "interface_id", "modality", "functions", "endpoint_ids", "resource_ids", "operated_by_participant_id", "standard_bindings", "source_uris" ], "additionalProperties": false } }, "relations": { "default": [], "type": "array", "items": { "type": "object", "properties": { "relation_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "kind": { "type": "string", "enum": [ "describes", "authenticates", "requires", "alternative_to", "precedes" ] }, "from": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false }, "to": { "type": "object", "properties": { "node_kind": { "type": "string", "enum": [ "resource", "endpoint", "interface", "surface_exclusion" ] }, "node_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" } }, "required": [ "node_kind", "node_id" ], "additionalProperties": false }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "relation_id", "kind", "from", "to", "source_uris" ], "additionalProperties": false } }, "offer_relations": { "default": [], "type": "array", "items": { "type": "object", "properties": { "offer_relation_proposal_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "offer_id": { "type": "string", "pattern": "^off_[0-9a-hjkmnp-tv-z]{26}$" }, "purpose": { "type": "string", "enum": [ "application_path", "redemption_path", "operating_path" ] }, "applicable_stages": { "minItems": 1, "type": "array", "items": { "type": "string", "enum": [ "evaluate", "sign_up", "pay", "provision", "operate" ] } }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "offer_relation_proposal_id", "offer_id", "purpose", "applicable_stages", "source_uris" ], "additionalProperties": false } }, "surface_exclusions": { "default": [], "type": "array", "items": { "type": "object", "properties": { "exclusion_id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "role": { "type": "string", "enum": [ "discovery", "terms", "eligibility", "pricing", "access", "checkout", "provisioning", "operations", "recovery", "authentication", "descriptor", "documentation", "policy", "status" ] }, "rationale": { "type": "string", "minLength": 1, "maxLength": 300 }, "source_uris": { "minItems": 1, "type": "array", "items": { "type": "string", "format": "uri" } } }, "required": [ "exclusion_id", "role", "rationale", "source_uris" ], "additionalProperties": false } }, "authority_intent": { "type": "string", "enum": [ "entity", "community" ] }, "declared_at": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" }, "base_authoring_file": { "type": "object", "properties": { "path": { "type": "string", "pattern": "^entities\\/[a-z0-9]{1,2}\\/[a-z0-9]+(?:-[a-z0-9]+)*\\.yaml$" }, "content": { "type": "string", "minLength": 1 }, "content_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "path", "content", "content_digest" ], "additionalProperties": false } }, "required": [ "command_contract", "scope_source_uris", "subject_roles", "assessment_targets", "participants", "resources", "endpoints", "interfaces", "relations", "offer_relations", "surface_exclusions" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "data": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "const": "invalid" }, "diagnostics": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "required", "invalid", "ambiguous_identity", "cross_entity_offer", "base_authoring_mismatch" ] }, "path": { "type": "string", "pattern": "^\\/.*" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "code", "path", "message" ], "additionalProperties": false } } }, "required": [ "status", "diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "identity_allocation_required" }, "diagnostics": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "required", "invalid", "ambiguous_identity", "cross_entity_offer", "base_authoring_mismatch" ] }, "path": { "type": "string", "pattern": "^\\/.*" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "code", "path", "message" ], "additionalProperties": false } } }, "required": [ "status", "diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "incomplete" }, "base_release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "entity_revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "diagnostics": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "required", "invalid", "ambiguous_identity", "cross_entity_offer", "base_authoring_mismatch" ] }, "path": { "type": "string", "pattern": "^\\/.*" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "code", "path", "message" ], "additionalProperties": false } } }, "required": [ "status", "base_release_id", "entity_id", "entity_revision_digest", "diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "conflict" }, "base_release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "entity_revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "diagnostics": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "required", "invalid", "ambiguous_identity", "cross_entity_offer", "base_authoring_mismatch" ] }, "path": { "type": "string", "pattern": "^\\/.*" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "code", "path", "message" ], "additionalProperties": false } } }, "required": [ "status", "base_release_id", "diagnostics" ], "additionalProperties": false }, { "type": "object", "properties": { "status": { "type": "string", "const": "materialized" }, "base_release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "entity_id": { "type": "string", "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$" }, "entity_revision_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "subject_display": { "type": "object", "properties": { "slug": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 240 } }, "required": [ "slug", "name" ], "additionalProperties": false }, "scope": { "type": "object", "properties": { "product": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false }, "funnel": { "type": "object", "properties": { "key": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "name": { "type": "string", "minLength": 1, "maxLength": 160 } }, "required": [ "key", "name" ], "additionalProperties": false } }, "required": [ "product", "funnel" ], "additionalProperties": false }, "declaration_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" }, "authoring_file": { "type": "object", "properties": { "path": { "type": "string", "pattern": "^entities\\/[a-z0-9]{1,2}\\/[a-z0-9]+(?:-[a-z0-9]+)*\\.yaml$" }, "content": { "type": "string", "minLength": 1 }, "content_digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": [ "path", "content", "content_digest" ], "additionalProperties": false }, "submission": { "type": "object", "properties": { "repository": { "type": "string", "const": "sourcey/agent-ready-services" }, "authority": { "type": "string", "const": "pull_request_merge" } }, "required": [ "repository", "authority" ], "additionalProperties": false }, "diagnostics": { "minItems": 0, "maxItems": 0, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "required", "invalid", "ambiguous_identity", "cross_entity_offer", "base_authoring_mismatch" ] }, "path": { "type": "string", "pattern": "^\\/.*" }, "message": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "code", "path", "message" ], "additionalProperties": false } } }, "required": [ "status", "base_release_id", "entity_id", "entity_revision_digest", "subject_display", "scope", "declaration_id", "authoring_file", "submission", "diagnostics" ], "additionalProperties": false } ] } }, "required": [ "release_id", "data" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "get_services", "title": "Get Sourcey paid services", "description": "Discover Sourcey's enabled paid agent services and canonical HTTP resources, including exact request and response contracts, price floor, policy links, and x402 discovery. Payment and durable job status remain on the product HTTP API; this read-only MCP tool never signs, settles, or interprets a payment.", "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "release_id": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "x402_discovery_url": { "type": "string", "const": "https://api.sourcey.com/.well-known/x402" }, "openapi_url": { "type": "string", "const": "https://api.sourcey.com/openapi.yml" }, "data": { "minItems": 1, "maxItems": 1, "type": "array", "items": { "type": "object", "properties": { "product_code": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }, "operation_id": { "type": "string", "pattern": "^[a-z][A-Za-z0-9]*$" }, "service_name": { "type": "string", "minLength": 1, "maxLength": 80 }, "description": { "type": "string", "minLength": 1, "maxLength": 499 }, "tags": { "type": "array", "items": [ { "type": "string", "minLength": 1, "maxLength": 48 }, { "type": "string", "minLength": 1, "maxLength": 48 }, { "type": "string", "minLength": 1, "maxLength": 48 }, { "type": "string", "minLength": 1, "maxLength": 48 }, { "type": "string", "minLength": 1, "maxLength": 48 } ] }, "floor_price": { "type": "object", "properties": { "currency": { "type": "string", "const": "usd" }, "minor_units": { "type": "number", "const": 4900 } }, "required": [ "currency", "minor_units" ], "additionalProperties": false }, "service_policy_url": { "type": "string", "format": "uri" }, "refund_policy_url": { "type": "string", "format": "uri" }, "resource_url": { "type": "string", "format": "uri" } }, "required": [ "product_code", "operation_id", "service_name", "description", "tags", "floor_price", "service_policy_url", "refund_policy_url", "resource_url" ], "additionalProperties": false } } }, "required": [ "release_id", "x402_discovery_url", "openapi_url", "data" ], "additionalProperties": false }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } } ], "resources": [], "resourceTemplates": [], "prompts": [], "instructions": "Use Sourcey for evidence-backed startup credits, startup programs, Agent Readiness report cards, and canonical service declarations. Treat unknown eligibility and unsupported readiness findings as unknown. Use get_services to discover paid HTTP work; payment never occurs inside MCP.", "x-sourcey-links": { "website": "https://sourcey.com", "api": "https://api.sourcey.com", "openapi": "https://api.sourcey.com/openapi.yml", "x402": "https://api.sourcey.com/.well-known/x402", "support": "https://sourcey.com/support", "privacy": "https://sourcey.com/privacy", "terms": "https://sourcey.com/terms", "skill": "https://sourcey.com/SKILL.md" }, "x-sourcey-boundary": { "reads": "The immutable catalog release and its closed provenance graph.", "actions": "Declaration preparation is a pure projection. No application, redemption, payment, account, claim, pull-request, or maintainer mutation is exposed." } }