DOCSEARCHbyAlgolia
Submit Docs

Soldered Electronics Agent Instructions

website·Indexed 34 days ago

https://soldered.com/documentation/

Guidelines and protocols for AI agents and personal shopping assistants to interact with the Soldered Electronics online store, including details on the Universal Commerce Protocol (UCP).

Tokens
627
Snippets
3
Records
5
Agent score
21%

What's inside Soldered Electronics

  1. Use the Shop skill for personal shopping agents

    For agents acting as personal assistants or 'buy-for-me' shoppers, installing the Shop skill is the recommended method for transacting. It provides a more reliable alternative to screen-scraping or scripting, handling cross-store catalog search, buyer-approved checkout via Shop Pay (removing the need for the agent to handle credit cards), order tracking, and reuse of authorized identity and payment methods.
    https://shop.app/SKILL.md

  2. Execute a UCP transaction flow

    The typical workflow for an agent using the Universal Commerce Protocol (UCP) to complete a purchase is as follows:

    1. Discover: Call GET /.well-known/ucp to confirm capabilities.
    2. Search: Use the search_catalog tool to find products.
    3. Cart: Use create_cart to add items.
    4. Checkout: Use create_checkout to initiate the purchase.
    5. Fulfill: Use update_checkout to specify shipping address and method.
    6. Complete: Use complete_checkout to finalize the order (requires buyer approval).

  3. UCP implementation constraints and requirements

    When using the UCP MCP endpoint, agents must adhere to the following rules:

    • Rate Limiting: The MCP endpoint is rate-limited per IP. Agents should implement a back-off strategy upon receiving 429 responses.
    • Buyer Context: To ensure accurate pricing and availability, agents should pass context.address_country and context.currency.
    • Supported Versions: The store supports UCP versions 2026-08-25 (latest stable), 2026-04-08, and 2026-01-23.

  4. Access product data via read-only endpoints

    Agents that only need to read store data without transacting can use the following unauthenticated endpoints to retrieve product and collection information.
    # Browse all products
GET /collections/all

# Get specific product page
GET /products/{handle}

# Get product data in JSON format
GET /products/{handle}.json

# Get collection page
GET /collections/{handle}

# Get collection products in JSON format
GET /collections/{handle}/products.json

# Search for products
GET /search?q={query}&type=product

  5. Interact with Soldered Electronics using Universal Commerce Protocol (UCP)

    Soldered Electronics implements the Universal Commerce Protocol (UCP) for agent-driven commerce. Agents can discover store capabilities and execute transactions via two primary endpoints. All checkouts require explicit human approval; agents must not complete payments without contemporaneous buyer consent.
    # Discovery: Returns merchant profile, versions, and capabilities
GET https://soldered.com/.well-known/ucp

# MCP Endpoint: Use tools/list to discover available tools
POST https://soldered.com/api/ucp/mcp
Content-Type: application/json