MCP: Model Context Protocol

Overview

MCP (Model Context Protocol) enables AI assistants like Claude Desktop to interact with soft.house directly. Users can create wishes, search products, and manage their commerce through natural language.

Our MCP server is deployed as a Cloudflare Worker with sub-200ms response times.

Available Tools

The soft.house MCP server exposes 22 tools:

search_products

Search for products across UCP-enabled merchants. Returns product listings with prices, images, and merchant info.

get_product_details

Get detailed information about a specific product including availability, shipping options, and reviews.

add_to_cart

Add a product to the shopping cart. Creates a wish with the product details.

view_cart

View the current shopping cart contents with totals.

remove_from_cart

Remove an item from the shopping cart.

update_cart_quantity

Update the quantity of an item in the cart.

checkout

Initiate checkout for the current cart. Requires user authentication with my.soft.house.

get_order_status

Check the status of an existing order.

list_orders

List recent orders for the authenticated user.

create_wish

Create a new wish (shopping goal) that AI agents can help fulfill.

list_wishes

List your active wishes and their fulfillment status.

get_wish

Get detailed information about a specific wish.

cancel_wish

Cancel an active wish.

list_merchants

List available UCP-enabled merchants that can fulfill orders.

discover_merchant

Discover a new UCP-enabled merchant by their domain name.

instant_checkout

Complete checkout instantly using ACP payment delegation. Requires authentication and a payment delegation.

create_payment_delegation

Create a payment delegation that allows AI agents to make purchases up to a specified limit.

check_delegation

Check the status of a payment delegation.

soft-house.skills.search

Natural-language routing-signal search across the soft.house canonical skills registry, with optional platform/protocol filters. Read-only; queries the live registry at api.soft.house.

soft-house.skills.get

Full metadata for one canonical skill: skill card, reasoning body, composability hints, current interface contract, and the contract version history (audit trail). Read-only; queries the live registry at api.soft.house.

soft-house.skills.by_platform

Catalog of canonical skills scoped to a single Pragma platform origin (e.g. all skills published by wish-now). Read-only; queries the live registry at api.soft.house.

soft-house.contracts.fetch

Retrieve the interface contract for a skill + semver version: JSONSchema input/output, error taxonomy, limits, cost signal, and composability hints. Omit version (or pass “current”) for the current contract. Read-only; queries the live registry at api.soft.house.

Claude Desktop Setup

1. Install the MCP Server

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "soft-house": {
      "url": "https://mcp.soft.house/sse",
      "headers": {
        "Authorization": "Bearer sk_test_..."
      }
    }
  }
}

2. Restart Claude Desktop

After saving the config, restart Claude Desktop to load the MCP server.

3. Start Using

Simply tell Claude what you want:

• “Find me a laptop under $1500”
• “Show my active wishes”
• “Check if soft.house is operational”

Server Architecture

Claude Desktop / AI Assistant
        |
        v
  MCP Server (Cloudflare Worker)
        |
        v
  soft.house API (api.soft.house)
        |
        v
  Supabase (PostgreSQL)

• Endpoint: https://mcp.soft.house/sse
• Transport: Server-Sent Events (SSE)
• Auth: Bearer token (API key)
• Response time: < 200ms average