Search a US wine marketplace, compare offers that ship to your state, and buy or track an order.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel an order that has not shipped yet. An authorized payment is released and a captured one is refunded in full; the buyer gets an email. Requires the buyer's approval.
Order id returned in `order.id` by complete_checkout.
Request metadata.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://vinovoss.com/mcp
Cancel an order that has not shipped yet. An authorized payment is released and a captured one is refunded in full; the buyer gets an email. Requires the buyer's approval.
| Argument | Type | Description |
|---|---|---|
| id* | string | Order id returned in `order.id` by complete_checkout. |
| meta* | object | Request metadata. |
{
"type": "object",
"required": [
"meta",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Order id returned in `order.id` by complete_checkout."
},
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
}
}
}Pay with a Stripe Shared Payment Token and place the order. Requires the buyer's approval.
| Argument | Type | Description |
|---|---|---|
| id* | string | Checkout id returned by create_checkout. |
| meta* | object | |
| checkout* | object |
{
"type": "object",
"required": [
"meta",
"id",
"checkout"
],
"properties": {
"id": {
"type": "string",
"description": "Checkout id returned by create_checkout."
},
"meta": {
"type": "object",
"allOf": [
{
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
},
{
"required": [
"ucp-agent",
"idempotency-key"
]
}
]
},
"checkout": {
"type": "object",
"required": [
"payment"
],
"properties": {
"payment": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/payment.json"
},
"signals": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/signals.json"
},
"attribution": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/attribution.json"
}
}
}
}
}Start a guest checkout for VinoVoss wines from one merchant. Buyers must be 21 or older.
| Argument | Type | Description |
|---|---|---|
| meta* | object | Request metadata. |
| checkout* | object |
{
"type": "object",
"required": [
"meta",
"checkout"
],
"properties": {
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
},
"checkout": {
"type": "object",
"required": [
"line_items"
],
"properties": {
"buyer": {
"allOf": [
{
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/buyer.json"
},
{
"properties": {
"date_of_birth": {
"type": "string",
"format": "date",
"description": "Required to purchase: YYYY-MM-DD. The buyer must be 21 or older."
}
}
}
]
},
"context": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/context.json"
},
"payment": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/payment.json"
},
"signals": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/signals.json"
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"id": {
"type": "string"
},
"item": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Variant id from the catalog."
}
}
},
"quantity": {
"type": "integer",
"minimum": 1
}
}
},
"minItems": 1,
"description": "The full list of items to buy. Every item must come from the same merchant."
},
"attribution": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/attribution.json"
},
"fulfillment": {
"type": "object",
"properties": {
"methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"const": "shipping"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": [
"string",
"null"
]
}
}
}
},
"destinations": {
"type": "array",
"items": {
"allOf": [
{
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/postal_address.json"
},
{
"properties": {
"id": {
"type": "string"
}
}
}
]
},
"maxItems": 1
},
"line_item_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"selected_destination_id": {
"type": [
"string",
"null"
]
}
}
},
"maxItems": 1
}
},
"description": "One shipping method with one US destination; set `selected_option_id` on its group to choose the delivery service."
}
}
}
}
}Read a checkout's current items, totals, status and policies.
| Argument | Type | Description |
|---|---|---|
| id* | string | Checkout id returned by create_checkout. |
| meta* | object | Request metadata. |
{
"type": "object",
"required": [
"meta",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Checkout id returned by create_checkout."
},
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
}
}
}Read an order placed with complete_checkout: its items, totals, shipment tracking, cancellation and refunds.
| Argument | Type | Description |
|---|---|---|
| id* | string | Order id returned in `order.id` by complete_checkout. |
| meta* | object | Request metadata. |
{
"type": "object",
"required": [
"meta",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Order id returned in `order.id` by complete_checkout."
},
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
}
}
}Look up VinoVoss products or variants by identifier. Results only include wines that ship to the buyer's US state: send context.address_country="US" and context.address_region=<2-letter state> when you know it; otherwise California (CA) is assumed.
| Argument | Type | Description |
|---|---|---|
| ids* | array | Identifiers to lookup. Implementations MUST support product ID and variant ID; MAY support secondary identifiers (SKU, handle, etc.). |
| context | object | |
| filters | object | Filter criteria to narrow returned products and variants. All specified filters combine with AND logic. |
| signals | object | |
| attribution | object |
{
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Identifiers to lookup. Implementations MUST support product ID and variant ID; MAY support secondary identifiers (SKU, handle, etc.)."
},
"context": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/context.json",
"type": "object"
},
"filters": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/search_filters.json",
"type": "object",
"description": "Filter criteria to narrow returned products and variants. All specified filters combine with AND logic."
},
"signals": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/signals.json",
"type": "object"
},
"attribution": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/attribution.json",
"type": "object"
}
},
"description": "Request body for catalog lookup."
}Refund an order in full. Only an order that has not shipped yet can be refunded here, and the refund also cancels it; the buyer gets an email. For partial refunds, returns or shipped orders, contact [email protected]. Requires the buyer's approval.
| Argument | Type | Description |
|---|---|---|
| id* | string | Order id returned in `order.id` by complete_checkout. |
| meta* | object | Request metadata. |
{
"type": "object",
"required": [
"meta",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Order id returned in `order.id` by complete_checkout."
},
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
}
}
}Search the VinoVoss product catalog. Results only include wines that ship to the buyer's US state: send context.address_country="US" and context.address_region=<2-letter state> when you know it; otherwise California (CA) is assumed.
| Argument | Type | Description |
|---|---|---|
| query | string | Free-text search query. |
| context | object | |
| filters | object | |
| signals | object | |
| pagination | object | |
| attribution | object |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Free-text search query."
},
"context": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/context.json",
"type": "object"
},
"filters": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/search_filters.json",
"type": "object"
},
"signals": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/signals.json",
"type": "object"
},
"pagination": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/pagination.json#/$defs/request",
"type": "object"
},
"attribution": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/attribution.json",
"type": "object"
}
}
}Change a checkout's buyer, shipping address or delivery service.
| Argument | Type | Description |
|---|---|---|
| id* | string | Checkout id returned by create_checkout. |
| meta* | object | Request metadata. |
| checkout* | object |
{
"type": "object",
"required": [
"meta",
"id",
"checkout"
],
"properties": {
"id": {
"type": "string",
"description": "Checkout id returned by create_checkout."
},
"meta": {
"type": "object",
"required": [
"ucp-agent"
],
"properties": {
"ucp-agent": {
"type": "object",
"required": [
"profile"
],
"properties": {
"profile": {
"type": "string",
"format": "uri",
"description": "URL to the platform's UCP profile."
}
},
"description": "Platform agent identification. Maps to HTTP UCP-Agent header."
},
"idempotency-key": {
"type": "string",
"format": "uuid",
"description": "Unique key for retry safety. Maps to HTTP Idempotency-Key header."
}
},
"description": "Request metadata.",
"additionalProperties": true
},
"checkout": {
"type": "object",
"required": [
"line_items"
],
"properties": {
"buyer": {
"allOf": [
{
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/buyer.json"
},
{
"properties": {
"date_of_birth": {
"type": "string",
"format": "date",
"description": "Required to purchase: YYYY-MM-DD. The buyer must be 21 or older."
}
}
}
]
},
"context": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/context.json"
},
"payment": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/payment.json"
},
"signals": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/signals.json"
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"id": {
"type": "string"
},
"item": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Variant id from the catalog."
}
}
},
"quantity": {
"type": "integer",
"minimum": 1
}
}
},
"minItems": 1,
"description": "The full list of items to buy. Every item must come from the same merchant."
},
"attribution": {
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/attribution.json"
},
"fulfillment": {
"type": "object",
"properties": {
"methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"const": "shipping"
},
"groups": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"selected_option_id": {
"type": [
"string",
"null"
]
}
}
}
},
"destinations": {
"type": "array",
"items": {
"allOf": [
{
"$ref": "https://ucp.dev/2026-04-08/schemas/shopping/types/postal_address.json"
},
{
"properties": {
"id": {
"type": "string"
}
}
}
]
},
"maxItems": 1
},
"line_item_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"selected_destination_id": {
"type": [
"string",
"null"
]
}
}
},
"maxItems": 1
}
},
"description": "One shipping method with one US destination; set `selected_option_id` on its group to choose the delivery service."
}
}
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 10, 2026.