velasyaromas3.mitiendanube.com

{
    "ucp": {
        "version": "2026-08-25",
        "status": "success",
        "services": {
            "dev.ucp.shopping": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/overview",
                    "transport": "rest",
                    "endpoint": "https://ucp.tiendanube.com/stores/3182606",
                    "schema": "https://ucp.dev/2026-08-25/services/shopping/rest.openapi.json"
                },
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/overview",
                    "transport": "mcp",
                    "endpoint": "https://ucp.tiendanube.com/stores/3182606/mcp",
                    "schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
                }
            ]
        },
        "capabilities": {
            "dev.ucp.shopping.cart": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/cart",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/cart.json"
                }
            ],
            "dev.ucp.shopping.checkout": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/checkout",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
                }
            ],
            "dev.ucp.shopping.order": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/order",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/order.json"
                }
            ],
            "dev.ucp.shopping.fulfillment": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/fulfillment",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/fulfillment.json",
                    "extends": "dev.ucp.shopping.checkout",
                    "config": {
                        "multi_destination": [],
                        "method_combinations": [
                            [
                                "shipping"
                            ]
                        ]
                    }
                }
            ],
            "dev.ucp.shopping.catalog.search": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/catalog/search",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_search.json"
                }
            ],
            "dev.ucp.shopping.catalog.lookup": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/catalog/lookup",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/catalog_lookup.json"
                }
            ],
            "dev.ucp.shopping.discount": [
                {
                    "version": "2026-08-25",
                    "spec": "https://ucp.dev/2026-08-25/specification/discount",
                    "schema": "https://ucp.dev/2026-08-25/schemas/shopping/discount.json",
                    "extends": [
                        "dev.ucp.shopping.checkout",
                        "dev.ucp.shopping.cart"
                    ]
                }
            ]
        },
        "payment_handlers": {}
    },
    "keys": [
        {
            "kid": "business_2026",
            "kty": "EC",
            "crv": "P-256",
            "x": "jpDXa9GrpkQNKKY8kPBFcxdm2NoAFf7mWPKw2BJ8Yqk",
            "y": "e6pTzBZ8jQTAY4gW40QgS2BdbLOsG8j9bfWWVzfM2xA",
            "use": "sig",
            "alg": "ES256"
        }
    ]
}

# Agent Instructions — velasyaromas

This document describes how AI agents can interact with velasyaromas's online store at https://velasyaromas3.mitiendanube.com.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

### Discovery

```
GET https://velasyaromas3.mitiendanube.com/.well-known/ucp
```

Returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.

### MCP Endpoint

```
POST https://velasyaromas3.mitiendanube.com/api/ucp/mcp
Content-Type: application/json
```

Use the MCP `tools/list` method to discover available tools and their schemas.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities
2. **Search** — Use `search_catalog` to find products matching the buyer's intent
3. **Cart** — Use `create_cart` to add desired items
4. **Checkout** — Use `create_checkout` to start the purchase flow
5. **Fulfill** — Use `update_checkout` to set shipping address and method
6. **Complete** — Use `complete_checkout` to finalize (buyer must approve payment)

### Supported UCP Versions
- `2026-04-08` (latest stable)
- `2026-01-23`

### Important Rules

- **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses.
- **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability.


## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting:

### Product Data
- Browse all products: `GET /productos`
- Product page: `GET /productos/{handle}`
- Category page: `GET /{handle}`
- Search: `GET /search?q={query}`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.

## Contact
- Contact: 
- Phone: 

## Platform

This store is built on [Tiendanube](https://www.tiendanube.com), the leading commerce platform powering hundreds of thousands of stores in LATAM. Tiendanube stores support UCP natively, enabling seamless agent-driven commerce.
- Start your own store: https://www.tiendanube.com
- UCP specification: https://ucp.dev