Zinvyl Marketplace Agent Gateway

Buy one fixed-scope Zinvyl service

buy_service

Idempotent

Five-field, retry-safe agent purchase path. Creates one bounded intent only when delegated authority covers the exact fee. Reusing buyer.request_id for an unchanged purchase returns the same intent. Adaptively selects Stripe-hosted checkout by default while preserving explicit delegated-card and MPP routes, and never claims payment before ledger verification.

Input Schema

Name	Required	Description
`buyer`	Yes
`offer_id`	Yes
`task_summary`	Yes	One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.
`purchase_authority`	Yes
`safe_scope_confirmed`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 28, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-23.6"New value: +"2026-10-27.1"
```

Changed1 schema field changedOct 27, 2026

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"
+]

Changed1 schema field changedOct 27, 2026

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"
+]

Changed1 schema field changedOct 27, 2026

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 / buyer / properties / acquisition_channel / 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 / buyer / properties / acquisition_channel / 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"
+]

Changed1 schema field changedOct 26, 2026

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"
+]

Changed1 schema field changedOct 26, 2026

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"
+]

Changed1 schema field changedOct 26, 2026

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"
+]

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / buyer / properties / acquisition_channel / 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 / buyer / properties / acquisition_channel / 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"
+]

Changed1 schema field changedOct 24, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-23.4"New value: +"2026-10-23.6"
```
Changed1 schema field changedOct 24, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-23.3"New value: +"2026-10-23.4"
```
Changed1 schema field changedOct 24, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-23.2"New value: +"2026-10-23.3"
```
Changed1 schema field changedOct 24, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-13.1"New value: +"2026-10-23.2"
```

Changed1 schema field changedOct 23, 2026

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"
+]

Changed1 schema field changedOct 23, 2026

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"
+]

Changed3 schema fields changedOct 21, 2026

changedInput schema / properties / purchase_authority / properties / funding_method / description

Previous value: -"Use auto unless the buyer client requires a specific rail. Auto defaults to Stripe-hosted checkout, which does not require prior Zinvyl customer payment-method enrollment. Legacy hosted card and ACH values remain accepted as aliases."New value: +"Use auto unless the buyer client requires a specific rail. Auto selects the owner-enrolled delegated card when the authenticated agent's organization has one; otherwise it returns hosted checkout. Legacy hosted card and ACH values remain accepted as aliases."

changedInput schema / properties / purchase_authority / properties / mandate_token / description

Previous value: -"Optional principal-issued signed single-transaction mandate. Required when Zinvyl's signed-mandate enforcement is enabled."New value: +"Optional principal-issued signed single-transaction restriction. Non-delegated-card autonomous routes require it; delegated card may instead use the active agent's owner-issued standing allowlist and ceiling."

changedInput schema / properties / purchase_authority / properties / payment_capabilities / description

Previous value: -"Optional client capabilities used for adaptive routing. Omit to receive the broadly compatible Stripe-hosted checkout route."New value: +"Optional client capabilities used for adaptive routing. An active organization delegated-card enrollment takes precedence for auto."

Changed4 schema fields changedOct 21, 2026

addedInput schema / properties / purchase_authority / properties / funding_method / default
```
Added value: +"auto"
```

changedInput schema / properties / purchase_authority / properties / funding_method / description

Previous value: -"Choose stripe_delegated_card only when an organization owner or administrator has completed the Stripe-hosted saved-card setup; otherwise use stripe_mpp_card."New value: +"Use auto unless the buyer client requires a specific rail. Auto defaults to Stripe-hosted checkout, which does not require prior Zinvyl customer payment-method enrollment. Legacy hosted card and ACH values remain accepted as aliases."

changedInput schema / properties / purchase_authority / properties / funding_method / enum

Previous value: -[
-  "stripe_mpp_card",
-  "stripe_delegated_card"
-]New value: +[
+  "auto",
+  "stripe_hosted_checkout",
+  "stripe_delegated_card",
+  "stripe_mpp_card",
+  "stripe_hosted_card",
+  "stripe_hosted_ach"
+]

addedInput schema / properties / purchase_authority / properties / payment_capabilities

Added value: +{
+  "description": "Optional client capabilities used for adaptive routing. Omit to receive the broadly compatible Stripe-hosted checkout route.",
+  "items": {
+    "enum": [
+      "checkout:stripe",
+      "delegated:stripe",
+      "mpp:stripe",
+      "card",
+      "bank:ach",
+      "wallet:apple_pay",
+      "wallet:google_pay",
+      "wallet:link"
+    ],
+    "type": "string"
+  },
+  "maxItems": 8,
+  "type": "array"
+}

Changed1 schema field changedOct 20, 2026

addedInput schema / properties / purchase_authority / properties / funding_method

Added value: +{
+  "description": "Choose stripe_delegated_card only when an organization owner or administrator has completed the Stripe-hosted saved-card setup; otherwise use stripe_mpp_card.",
+  "enum": [
+    "stripe_mpp_card",
+    "stripe_delegated_card"
+  ],
+  "type": "string"
+}

Changed1 schema field changedOct 18, 2026

addedInput schema / properties / purchase_authority / properties / mandate_token

Added value: +{
+  "description": "Optional principal-issued signed single-transaction mandate. Required when Zinvyl's signed-mandate enforcement is enabled.",
+  "maxLength": 4096,
+  "minLength": 80,
+  "type": "string"
+}

Changed1 schema field changedOct 17, 2026

addedInput schema / properties / buyer / properties / continuation_token

Added value: +{
+  "description": "Opaque token returned with a matched offer. Include it so acknowledgement, authority, checkout, and funding remain one correlated journey.",
+  "pattern": "^[a-f0-9]{64}$",
+  "type": "string"
+}

Changed1 schema field changedOct 15, 2026

changedInput schema / properties / buyer / properties / acquisition_channel / enum

Previous value: -[
-  "direct",
-  "direct_agent",
-  "mcp_registry",
-  "a2a_registry",
-  "ai_agents_directory",
-  "toku",
-  "gohirehumans",
-  "toll_bench",
-  "callboard",
-  "recruiting_bot",
-  "peerpush",
-  "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"
+]

Changed1 schema field changedOct 15, 2026

addedInput schema / properties / task_summary / description

Added value: +"One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets."

Changed2 schema fields changedOct 15, 2026

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.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"
+]

changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-10-05.1"New value: +"2026-10-13.1"
```

Changed2 schema fields changedOct 11, 2026

addedInput schema / properties / buyer / properties / request_id

Added value: +{
+  "description": "Buyer-scoped idempotency key. Reuse it only when retrying this exact purchase attempt.",
+  "maxLength": 128,
+  "minLength": 8,
+  "pattern": "^[A-Za-z0-9._:-]+$",
+  "type": "string"
+}

changedInput schema / properties / buyer / required

Previous value: -[
-  "organization",
-  "contact_email"
-]New value: +[
+  "organization",
+  "contact_email",
+  "request_id"
+]

Changed1 schema field changedOct 8, 2026

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.freight.full-workflow-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.freight.full-workflow-audit.v1",
+  "zinvyl.content.ai-marketing-pilot.v1"
+]

Changed1 schema field changedOct 7, 2026

changedInput schema / properties / buyer / properties / acquisition_channel / enum

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

Changed2 schema fields changedOct 6, 2026

changedInput schema / properties / buyer / properties / acquisition_channel / description

Previous value: -"Optional discovery source for revenue attribution."New value: +"Optional allowlisted discovery source for privacy-minimized revenue attribution."

changedInput schema / properties / buyer / properties / acquisition_channel / enum

Previous value: -[
-  "direct",
-  "toku",
-  "ai_agents_directory",
-  "gohirehumans",
-  "toll_bench",
-  "other"
-]New value: +[
+  "direct",
+  "mcp_registry",
+  "a2a_registry",
+  "ai_agents_directory",
+  "toku",
+  "gohirehumans",
+  "toll_bench",
+  "callboard",
+  "recruiting_bot",
+  "peerpush",
+  "other"
+]

Changed1 schema field changedOct 6, 2026
- changedInput schema / properties / purchase_authority / properties / terms_version / const
```
Previous value: -"2026-09-26.1"New value: +"2026-10-05.1"
```

Changed2 schema fields changedOct 6, 2026

addedInput schema / properties / buyer / properties / acquisition_channel

Added value: +{
+  "description": "Optional discovery source for revenue attribution.",
+  "enum": [
+    "direct",
+    "toku",
+    "ai_agents_directory",
+    "gohirehumans",
+    "toll_bench",
+    "other"
+  ],
+  "type": "string"
+}

addedInput schema / properties / purchase_authority / properties / maximum_amount / description

Added value: +"Maximum authorized amount in minor currency units (cents); 4900 means $49.00."

AddedOct 6, 2026

TDQS

B3.4/5.0

Behavior4/5

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

Annotations already cover safety and idempotency, and the description adds real value beyond them: idempotent replay via buyer.request_id, adaptive rail selection to Stripe-hosted checkout, and a promise not to claim payment before ledger verification. It does not disclose failure/error behavior or what is returned, but for an annotated tool this is solid added context.

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

Conciseness4/5

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

Three dense sentences that front-load the retry-safe intent creation and follow with routing and verification behavior; little waste. The routing sentence is jargon-heavy ('while preserving explicit delegated-card and MPP routes') but still earns its place.

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?

No output schema exists, and the description does not say what an intent response contains or how errors surface. With a 5-required-field nested mutation and 20% schema coverage, the description covers the purchase semantics but leaves several required inputs and the return shape unexplained.

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 20%, so the description must compensate for opaque fields like offer_id, safe_scope_confirmed, and the purchase_authority nesting. It only touches request_id reuse and the authority/amount precondition, leaving safe_scope_confirmed, offer selection, and most of the authority object unexplained beyond the schema.

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

Purpose4/5

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

States a specific verb and resource ('Creates one bounded intent') scoped to a fixed-price service with an authority precondition, which separates it from the matching/discovery siblings. It does not name the closest alternatives (create_purchase_intent, preflight_agent_purchase, buy_matching_service), so an agent must still infer the boundary.

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

Usage Guidelines3/5

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

The authority precondition ('only when delegated authority covers the exact fee') implies when this tool is applicable, and idempotent retry use is specified. However, no explicit when-not guidance or routing to siblings such as preflight_agent_purchase or resume_agent_purchase is given, leaving the purchase-vs-preflight choice to inference.

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?