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 three tools:

create_wish

Create a new wish through natural language:

{
  "name": "create_wish",
  "description": "Create a new wish for product discovery",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": { "type": "string", "description": "What you're looking for" },
      "budget_max": { "type": "number", "description": "Maximum budget in USD" },
      "category": { "type": "string", "description": "Product category" }
    },
    "required": ["query"]
  }
}

search_wishes

Search existing wishes:

{
  "name": "search_wishes",
  "description": "Search your wishes by query or status",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": { "type": "string" },
      "status": { "type": "string", "enum": ["active", "fulfilled", "cancelled"] },
      "limit": { "type": "number", "default": 10 }
    }
  }
}

get_status

Check system health and your account status:

{
  "name": "get_status",
  "description": "Check soft.house system status and your account info",
  "input_schema": {
    "type": "object",
    "properties": {}
  }
}

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