Zinvyl Marketplace Agent Gateway
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
Matches sanitized business needs to fixed-price services and routes authorized agents to purchase.
| Author | com.zinvyl |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 2049 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Zinvyl Marketplace Agent Gateway": {
"url": "https://zinvyl.com/marketplace/agent-mcp",
"transport": "streamable-http"
}
}
}
Measured tools (14)
acknowledge_purchase_offerRecords that an operator-controlled agent actually received and retained one exact offer and registered a durable return method. This creates no order, grants no authority, stores no callback URL, and never proves payment.
Parameters:
continuation_token(required) — stringoffer_id(required) — stringstable_agent_id(required) — string — Stable agent or installation identifier. Zinvyl binds a salted one-way commitment to the continuation and never stores this value raw.continuation_method(required) — stringoperator_linked_confirmed(required) — booleanoffer_received_and_stored(required) — booleanapproval_mode(required) — stringcurrency— stringmaximum_amount— integerallowed_offer_ids— arrayacquisition_source— string
Hints: read-only no · destructive no · idempotent yes · open-world no
preflight_agent_purchaseread-onlyRead-only transaction check. Verifies product match, credential, standing agent policy or narrower signed mandate, exact offer allowlist, price ceiling, current terms, sanitized scope, capacity, and payment-route readiness. It creates no intent, checkout, charge, order, or telemetry event.
Parameters:
buyer(required) — objecttask_summary(required) — string — One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.purchase_authority(required) — objectsafe_scope_confirmed(required) — boolean
Hints: read-only yes · destructive no · idempotent yes · open-world no
resume_agent_purchaseread-onlyRead-only durable continuation. Returns the exact observed stop and next executable action for a previously returned opaque continuation token. It creates no purchase, checkout, charge, or order.
Parameters:
continuation_token(required) — stringoffer_id(required) — stringacquisition_source— string
Hints: read-only yes · destructive no · idempotent yes · open-world no
find_serviceOptional demand-feedback route. Describe one authorized sanitized business need once. Zinvyl returns the best fixed-scope offer and next purchase action, or records an unsupported need as privacy-minimized product telemetry. For read-only matching, start with qualify_task.
Parameters:
request_summary(required) — string — One sanitized business outcome. Do not include names, email addresses, phone numbers, credentials, payment data, personal data, confidential text, or production secrets.authorized_to_share(required) — boolean — True only when the requester is authorized to share this sanitized need with Zinvyl for matching and aggregate product planning.contains_no_personal_data_or_secrets(required) — boolean — True only after removing personal data, credentials, confidential material, and payment data.source— string — Optional allowlisted source where the agent discovered Zinvyl.industry— string — Optional broad industry only; do not name a person or confidential project.budget_cents— integer — Optional buyer-stated total budget in USD cents. This is demand telemetry, not spending authority or proof of funds.category_hint— stringagent_tool_type— stringturnaround_days— integer — Optional requested turnaround in calendar days.requested_output— string — Optional sanitized deliverable type, such as weekly report or data export.near_match_offer_id— string — Optional closest offer; it does not place unsupported work in scope.
Hints: read-only no · destructive no · idempotent yes · open-world no
list_offersread-onlyUse when comparing Zinvyl's full eight-offer catalog. For a single sanitized need, start with read-only qualify_task. Returns price, delivery window, required inputs, exclusions, and direct intake URL; use get_acceptance_tests only after selecting an offer.
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_purchase_requirementsread-onlyUse after selecting an offer. Returns the exact price, five-field buy_service contract, delegated-authority requirements, machine-payment route, capacity limits, and authoritative funding rule without creating an intent.
Parameters:
offer_id(required) — string — Exact published offer ID returned by list_offers or qualify_task.
Hints: read-only yes · destructive no · idempotent yes · open-world no
buy_matching_serviceOne-call path for a buyer agent that has explicit delegated authority for a stated allowlist of exact Zinvyl offers. Zinvyl matches one sanitized outcome and creates a bounded purchase intent only when the matched offer is allowlisted and its exact fee fits the delegated ceiling. A catalog gap or authority mismatch creates no order or payment claim.
Parameters:
buyer(required) — objecttask_summary(required) — string — One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.purchase_authority(required) — objectsafe_scope_confirmed(required) — boolean
Hints: read-only no · destructive no · idempotent yes · open-world yes
buy_serviceFive-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.
Parameters:
offer_id(required) — stringbuyer(required) — objecttask_summary(required) — string — One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.purchase_authority(required) — objectsafe_scope_confirmed(required) — boolean
Hints: read-only no · destructive no · idempotent yes · open-world yes
recover_abandoned_purchaseRecovers the original transaction for the same authenticated buyer, authority policy, request ID, offer, sanitized scope, amount, currency, funding route, and current terms. Before funding it resumes an expired reservation; after verified funding it safely reissues scoped order access without charging again.
Parameters:
previous_intent_id(required) — stringoffer_id(required) — stringbuyer(required) — objecttask_summary(required) — string — One sanitized bounded outcome. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.purchase_authority(required) — objectsafe_scope_confirmed(required) — boolean
Hints: read-only no · destructive no · idempotent yes · open-world yes
create_purchase_intentCompatibility alias for existing clients; new integrations should use buy_service. Use only after selecting one offer when the calling agent has explicit delegated authority for that exact fixed fee. Creates the governed purchase intent and quote, then returns adaptive Stripe-hosted checkout by default. It does not itself claim payment or start work.
Parameters:
offer_id(required) — string — Exact published offer ID returned by find_service or list_offers.buyer_organization(required) — string — Legal or operating name of the buying organization.buyer_contact_email(required) — string — Email for the authorized purchasing contact and order communications.task_summary(required) — string — Sanitized, bounded task summary. Never include credentials, tokens, payment data, personal data, confidential files, or production secrets.delegated_purchase_authority_confirmed(required) — boolean — True only when the agent is acting within explicit delegated authority for this exact offer and published amount.bounded_scope_confirmed(required) — boolean — True only when the buyer controls the inputs and this sanitized request is non-production and contains no secrets.terms_accepted(required) — boolean — True only when the authorized buyer has accepted Zinvyl terms version 2026-10-23.6.
Hints: read-only no · destructive no · idempotent no · open-world yes
qualify_taskread-onlyUse when a buyer's sanitized problem is not yet mapped to an offer. Returns one fixed offer ID, a broader-service route, or a scope-reduction decision; it performs no diagnosis and creates no order.
Parameters:
summary(required) — string — Sanitized expected-versus-actual outcome. Do not include credentials, tokens, personal data, or production secrets.
Hints: read-only yes · destructive no · idempotent yes · open-world no
match_or_capture_demandCompatibility alias for existing clients; new integrations should use qualify_task first and find_service only after consent. Returns an existing fixed offer when one matches. Otherwise records privacy-minimized product-demand telemetry for owner review; it creates no order, quote, outreach, funding claim, or delivery commitment.
Parameters:
request_summary(required) — string — One sanitized business outcome. Do not include names, email addresses, phone numbers, credentials, payment data, personal data, confidential text, or production secrets.authorized_to_share(required) — boolean — True only when the requester is authorized to share this sanitized need with Zinvyl for matching and aggregate product planning.contains_no_personal_data_or_secrets(required) — boolean — True only after removing personal data, credentials, confidential material, and payment data.source— string — Optional allowlisted source where the agent discovered Zinvyl.industry— string — Optional broad industry only; do not name a person or confidential project.budget_cents— integer — Optional buyer-stated total budget in USD cents. This is demand telemetry, not spending authority or proof of funds.category_hint— stringagent_tool_type— stringturnaround_days— integer — Optional requested turnaround in calendar days.requested_output— string — Optional sanitized deliverable type, such as weekly report or data export.near_match_offer_id— string — Optional closest offer; it does not place unsupported work in scope.
Hints: read-only no · destructive no · idempotent yes · open-world no
get_acceptance_testsread-onlyUse after qualify_task or list_offers identifies an offer and detailed scope review is useful. Returns the exact delivery acceptance tests, exclusions, and evidence boundaries that limit what Zinvyl may claim for that offer.
Parameters:
offer_id(required) — string — Exact published offer ID returned by qualify_task or list_offers, including zinvyl.freight.workflow-audit.v1, zinvyl.freight.full-workflow-audit.v1, zinvyl.api.failure-triage.v1, and zinvyl.api.workflow-failure-rescue.v1.
Hints: read-only yes · destructive no · idempotent yes · open-world no
prepare_purchase_routeread-onlyCompatibility inspection alias for existing clients; new integrations should use get_purchase_requirements and buy_service. Use only after selecting an offer and confirming explicit purchasing authority. Returns the purchase-intent schema and payment-route API endpoint; it does not create, fund, verify, or start an order.
Parameters:
offer_id(required) — string — Exact published offer ID returned by qualify_task or list_offers, including zinvyl.freight.workflow-audit.v1, zinvyl.freight.full-workflow-audit.v1, zinvyl.api.failure-triage.v1, and zinvyl.api.workflow-failure-rescue.v1.human_authorized_to_fund(required) — boolean — True only when an authorized representative approved the request or an authorized purchasing agent is acting within explicit delegated authority for this offer, amount, and material limits.
Hints: read-only yes · destructive no · idempotent yes · open-world yes
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.