{ "mcpSpec": "0.3.1", "mcpVersion": "2025-11-25", "server": { "name": "sourcey", "version": "1.1.1", "description": "Find and verify startup credits and deals in Sourcey's provenance-bound registry.", "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 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." }, "vendors": { "minItems": 1, "maxItems": 10, "type": "array", "items": { "type": "string", "minLength": 1 }, "description": "Current vendor 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}$" } }, "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}$" } }, "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": { "tier": { "type": "string", "enum": [ "observed", "signed", "verified" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "basis_event_ids": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "tier", "freshness", "dispute", "basis_event_ids" ], "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": { "vendor": { "type": "string", "minLength": 1, "description": "Current vendor slug or immutable entity ID." }, "offer": { "type": "string", "minLength": 1, "description": "Current offer slug." } }, "required": [ "vendor", "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}$" } }, "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}$" } }, "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": { "tier": { "type": "string", "enum": [ "observed", "signed", "verified" ] }, "freshness": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "dispute": { "type": "string", "enum": [ "none", "open", "resolved" ] }, "basis_event_ids": { "minItems": 1, "type": "array", "items": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "tier", "freshness", "dispute", "basis_event_ids" ], "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.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 } } ], "resources": [], "resourceTemplates": [], "prompts": [], "x-sourcey-boundary": { "reads": "The immutable catalog release and its closed provenance graph.", "actions": "No application, redemption, payment, account, claim, or maintainer operation is exposed." } }