@reponse/mcp

Headless Commerce MCP Server — Connect Claude, Cursor, or Windsurf to your Reponse store in 30 seconds.

What is this?

An MCP (Model Context Protocol) server that gives AI agents full access to a Reponse Commerce backend — catalog browsing, cart management, checkout, order support, tickets, discounts, and more.

20 tools covering the complete e-commerce lifecycle:

| Category | Tools | |---|---| | Catalog | list_products, get_product, list_collections | | Cart | create_cart, get_cart, add_to_cart, update_cart_item, remove_cart_item | | Checkout | create_checkout | | Order Support | update_shipping_address, resend_order_confirmation, resend_invoice, cancel_order | | Tickets | list_tickets, get_ticket, create_ticket, reply_to_ticket | | Discounts | list_discount_codes, validate_discount_code, create_discount_code |

Quick Start

1. Get an API Key

Sign up at app.reponse.ai and go to Settings → API Keys to generate a key (sk_live_...).

2. Configure your AI client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "reponse": {
      "command": "npx",
      "args": ["-y", "@reponse/mcp"],
      "env": {
        "REPONSE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "reponse": {
      "command": "npx",
      "args": ["-y", "@reponse/mcp"],
      "env": {
        "REPONSE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "reponse": {
      "command": "npx",
      "args": ["-y", "@reponse/mcp"],
      "env": {
        "REPONSE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

3. Start chatting

Ask your AI assistant:

• "Show me all products in the store"
• "Create a cart with 2x the blue hoodie"
• "Generate a checkout link for cart xyz"
• "Cancel order #1234 — customer changed their mind"
• "List all open support tickets"

Environment Variables

| Variable | Required | Description | |---|---|---| | REPONSE_API_KEY | ✅ | Your Reponse API key (sk_live_... or sk_test_...) | | REPONSE_API_URL | ❌ | API base URL (default: https://api.reponse.ai) |

Tools Reference

Catalog

• list_products — List products with optional search query and limit
• get_product — Get a single product by UUID with variants, images, and pricing
• list_collections — List product collections/categories

Cart

• create_cart — Create a new cart, optionally with initial items
• get_cart — Retrieve cart contents and totals
• add_to_cart — Add items to an existing cart
• update_cart_item — Update quantity of a cart line item (set to 0 to remove)
• remove_cart_item — Remove a line item from a cart

Checkout

• create_checkout — Generate a Stripe Checkout payment URL for a cart

Order Support

• update_shipping_address — Update shipping address (requires identity verification, order must be unfulfilled)
• resend_order_confirmation — Resend confirmation email (rate limited: 3/hour)
• resend_invoice — Resend invoice PDF (rate limited: 3/hour)
• cancel_order — Cancel order with Stripe refund (rate limited: 1/hour, 3/30 days)

Tickets

• list_tickets — List support tickets with filters (status, category, email)
• get_ticket — Get ticket details with full conversation history
• create_ticket — Open a new support ticket for a customer
• reply_to_ticket — Send a reply to an existing ticket

Discounts

• list_discount_codes — List discount codes with active/type filters
• validate_discount_code — Validate a code and calculate potential savings
• create_discount_code — Create a new discount code (percentage, fixed, free shipping, BXGY)

What is Reponse?

Reponse is an AI-native headless commerce platform. It provides a complete e-commerce backend (catalog, cart, checkout, orders, CRM, support) with a conversational AI sales engine built in.

This MCP server connects any AI agent to a Reponse store via the public REST API (/v1/*).

License

MIT