Zinvyl Marketplace Agent Gateway

Acknowledge and retain a Zinvyl purchase offer

acknowledge_purchase_offer

Idempotent

Records that an agent actually received and retained one exact offer. A durable return method, operator linkage, and delegated limits are optional and recorded only when truthfully supplied. Receipt-only acknowledgement creates no order, grants no authority, stores no callback URL, and never proves payment.

Input Schema

Name	Required	Description
`currency`	No
`offer_id`	Yes
`approval_mode`	No
`maximum_amount`	No
`stable_agent_id`	No	Optional stable agent or installation identifier. Supply it only together with continuation_method; Zinvyl stores only a one-way commitment when operator linkage is truthfully declared.
`allowed_offer_ids`	No
`acquisition_source`	No
`continuation_token`	Yes
`continuation_method`	No	Optional durable return method. Supply it only together with stable_agent_id.
`offer_received_and_stored`	Yes
`operator_linked_confirmed`	No	Optional. True only when a human operator actually controls this agent or installation; true requires the paired durable-return fields.

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 27, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1",
-  "zinvyl.factory.automation-compliant-market-monitor.v1",
-  "zinvyl.factory.content-instructional-video-pack.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.quality.trace-readiness-check.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1",
+  "zinvyl.factory.content-instructional-video-pack.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -16New value: +17
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1",
-  "zinvyl.factory.automation-compliant-market-monitor.v1",
-  "zinvyl.factory.content-instructional-video-pack.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.quality.trace-readiness-check.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1",
+  "zinvyl.factory.content-instructional-video-pack.v1"
+]

Changed3 schema fields changedOct 27, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1",
-  "zinvyl.factory.automation-compliant-market-monitor.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1",
+  "zinvyl.factory.content-instructional-video-pack.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -15New value: +16
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1",
-  "zinvyl.factory.automation-compliant-market-monitor.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1",
+  "zinvyl.factory.content-instructional-video-pack.v1"
+]

Changed3 schema fields changedOct 27, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -14New value: +15
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1",
-  "zinvyl.factory.development-mcp-server-starter.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1",
+  "zinvyl.factory.automation-compliant-market-monitor.v1"
+]

Changed1 schema field changedOct 27, 2026

changedInput schema / properties / acquisition_source / enum

Previous value: -[
-  "direct",
-  "direct_agent",
-  "mcp_registry",
-  "a2a_registry",
-  "ai_agents_directory",
-  "allagents",
-  "toku",
-  "gohirehumans",
-  "toll_bench",
-  "callboard",
-  "recruiting_bot",
-  "peerpush",
-  "speedbot",
-  "procurement_agent_operator",
-  "workflow_orchestrator",
-  "shopping_agent",
-  "partner_operator",
-  "other",
-  "zinvyl_offer_feed"
-]New value: +[
+  "direct",
+  "direct_agent",
+  "mcp_registry",
+  "a2a_registry",
+  "ai_agents_directory",
+  "allagents",
+  "toku",
+  "gohirehumans",
+  "toll_bench",
+  "callboard",
+  "recruiting_bot",
+  "peerpush",
+  "speedbot",
+  "lumen_b2b",
+  "procurement_agent_operator",
+  "workflow_orchestrator",
+  "shopping_agent",
+  "partner_operator",
+  "other",
+  "zinvyl_offer_feed"
+]

Changed1 schema field changedOct 27, 2026

changedInput schema / properties / acquisition_source / enum

Previous value: -[
-  "direct",
-  "direct_agent",
-  "mcp_registry",
-  "a2a_registry",
-  "ai_agents_directory",
-  "allagents",
-  "toku",
-  "gohirehumans",
-  "toll_bench",
-  "callboard",
-  "recruiting_bot",
-  "peerpush",
-  "procurement_agent_operator",
-  "workflow_orchestrator",
-  "shopping_agent",
-  "partner_operator",
-  "other",
-  "zinvyl_offer_feed"
-]New value: +[
+  "direct",
+  "direct_agent",
+  "mcp_registry",
+  "a2a_registry",
+  "ai_agents_directory",
+  "allagents",
+  "toku",
+  "gohirehumans",
+  "toll_bench",
+  "callboard",
+  "recruiting_bot",
+  "peerpush",
+  "speedbot",
+  "procurement_agent_operator",
+  "workflow_orchestrator",
+  "shopping_agent",
+  "partner_operator",
+  "other",
+  "zinvyl_offer_feed"
+]

Changed3 schema fields changedOct 26, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -13New value: +14
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1",
-  "zinvyl.factory.workflow-single-automation-blueprint.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1",
+  "zinvyl.factory.development-mcp-server-starter.v1"
+]

Changed3 schema fields changedOct 26, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -12New value: +13
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1",
-  "zinvyl.quality.ai-workflow-failure-audit.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1",
+  "zinvyl.factory.workflow-single-automation-blueprint.v1"
+]

Changed3 schema fields changedOct 26, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -11New value: +12
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1",
-  "zinvyl.analytics.operations-bi-dashboard.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1",
+  "zinvyl.quality.ai-workflow-failure-audit.v1"
+]

Changed4 schema fields changedOct 25, 2026

addedInput schema / properties / continuation_method / description

Added value: +"Optional durable return method. Supply it only together with stable_agent_id."

changedInput schema / properties / operator_linked_confirmed / description

Previous value: -"True only when a human operator actually controls this agent or installation. False still permits receipt acknowledgement and return-path registration without inventing operator linkage."New value: +"Optional. True only when a human operator actually controls this agent or installation; true requires the paired durable-return fields."

changedInput schema / properties / stable_agent_id / description

Previous value: -"Stable agent or installation identifier. Zinvyl binds a salted one-way commitment to the continuation and never stores this value raw."New value: +"Optional stable agent or installation identifier. Supply it only together with continuation_method; Zinvyl stores only a one-way commitment when operator linkage is truthfully declared."

changedInput schema / required

Previous value: -[
-  "continuation_token",
-  "offer_id",
-  "stable_agent_id",
-  "continuation_method",
-  "operator_linked_confirmed",
-  "offer_received_and_stored",
-  "approval_mode"
-]New value: +[
+  "continuation_token",
+  "offer_id",
+  "offer_received_and_stored"
+]

Changed2 schema fields changedOct 25, 2026

removedInput schema / properties / operator_linked_confirmed / const
```
Removed value: -true
```

addedInput schema / properties / operator_linked_confirmed / description

Added value: +"True only when a human operator actually controls this agent or installation. False still permits receipt acknowledgement and return-path registration without inventing operator linkage."

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / acquisition_source / enum

Previous value: -[
-  "direct",
-  "direct_agent",
-  "mcp_registry",
-  "a2a_registry",
-  "ai_agents_directory",
-  "toku",
-  "gohirehumans",
-  "toll_bench",
-  "callboard",
-  "recruiting_bot",
-  "peerpush",
-  "procurement_agent_operator",
-  "workflow_orchestrator",
-  "shopping_agent",
-  "partner_operator",
-  "other",
-  "zinvyl_offer_feed"
-]New value: +[
+  "direct",
+  "direct_agent",
+  "mcp_registry",
+  "a2a_registry",
+  "ai_agents_directory",
+  "allagents",
+  "toku",
+  "gohirehumans",
+  "toll_bench",
+  "callboard",
+  "recruiting_bot",
+  "peerpush",
+  "procurement_agent_operator",
+  "workflow_orchestrator",
+  "shopping_agent",
+  "partner_operator",
+  "other",
+  "zinvyl_offer_feed"
+]

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / acquisition_source / enum

Previous value: -[
-  "direct",
-  "direct_agent",
-  "mcp_registry",
-  "a2a_registry",
-  "ai_agents_directory",
-  "toku",
-  "gohirehumans",
-  "toll_bench",
-  "callboard",
-  "recruiting_bot",
-  "peerpush",
-  "procurement_agent_operator",
-  "workflow_orchestrator",
-  "shopping_agent",
-  "partner_operator",
-  "other"
-]New value: +[
+  "direct",
+  "direct_agent",
+  "mcp_registry",
+  "a2a_registry",
+  "ai_agents_directory",
+  "toku",
+  "gohirehumans",
+  "toll_bench",
+  "callboard",
+  "recruiting_bot",
+  "peerpush",
+  "procurement_agent_operator",
+  "workflow_orchestrator",
+  "shopping_agent",
+  "partner_operator",
+  "other",
+  "zinvyl_offer_feed"
+]

Changed3 schema fields changedOct 23, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -10New value: +11
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1",
-  "zinvyl.data.csv-cleanup-starter.v1",
-  "zinvyl.data.csv-cleanup-complete.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1",
+  "zinvyl.analytics.operations-bi-dashboard.v1"
+]

Changed3 schema fields changedOct 23, 2026

changedInput schema / properties / allowed_offer_ids / items / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1"
+]

changedInput schema / properties / allowed_offer_ids / maxItems
```
Previous value: -8New value: +10
```

changedInput schema / properties / offer_id / enum

Previous value: -[
-  "zinvyl.venture.evidence-brief.v1",
-  "zinvyl.venture.prototype-scope.v1",
-  "zinvyl.freight.workflow-audit.v1",
-  "zinvyl.api.workflow-failure-rescue.v1",
-  "zinvyl.api.failure-triage.v1",
-  "zinvyl.api.workflow-reliability-care.v1",
-  "zinvyl.freight.full-workflow-audit.v1",
-  "zinvyl.content.ai-marketing-pilot.v1"
-]New value: +[
+  "zinvyl.venture.evidence-brief.v1",
+  "zinvyl.venture.prototype-scope.v1",
+  "zinvyl.freight.workflow-audit.v1",
+  "zinvyl.api.workflow-failure-rescue.v1",
+  "zinvyl.api.failure-triage.v1",
+  "zinvyl.api.workflow-reliability-care.v1",
+  "zinvyl.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1",
+  "zinvyl.data.csv-cleanup-starter.v1",
+  "zinvyl.data.csv-cleanup-complete.v1"
+]

AddedOct 17, 2026

TDQS

A4.2/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations, it explicitly lists important non-effects: no order is created, no authority granted, no callback URL stored, and no payment proven. It also clarifies that optional durable-return, operator-linkage, and delegated-limit data are recorded only when truthfully supplied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three tightly written sentences, front-loaded with the core action and followed by optional-field guidance and critical negative guarantees. Every sentence adds distinct value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a mutation tool with 11 parameters and no output schema, the description gives strong side-effect and optionality context but does not explain return behavior or fully document the parameter surface. Annotations cover safety, but the description still leaves meaningful complexity unaddressed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 27% across 11 parameters, so the description needs to carry significant semantic weight. It adds useful guidance about optional durable-return, operator-linkage, and delegated-limit fields, but it leaves required and enum-heavy parameters such as continuation_token, offer_id, allowed_offer_ids, acquisition_source, and currency largely unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it records that an agent received and retained one exact offer. The negative guarantees ('creates no order, grants no authority... never proves payment') clearly distinguish this receipt acknowledgement from sibling purchase/order tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It makes the use context clear: acknowledge receipt and retention of an offer, not create an order or prove payment. It does not explicitly name sibling tools or spell out sequencing with preflight/create intent, so it stops short of full when/when-not/alternatives guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Zinvyl Marketplace Agent Gateway tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?