MCP Server

Overview

Reponse ships a **Model Context Protocol (MCP)** server that exposes commerce operations as typed tools to any MCP-compatible client — including Claude, Cursor, Windsurf, and custom agent orchestrators. This lets an AI agent browse the catalog, manage carts, check orders, and act on loyalty data without building a custom integration.

Prerequisites

Step 1 — Configure the MCP client

Add the Reponse MCP server to your client configuration. For **Claude Desktop**, edit `claude_desktop_config.json`:

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

For **Cursor**, add the same entry under `.cursor/mcp.json`:

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

Step 2 — Verify the connection

Once configured, your MCP client discovers the available tools automatically. You should see tools prefixed with `reponse_` in your client's tool list.

Available tools

The MCP server exposes the following tools, mapping directly to the `/v1` REST API:

Tool input/output schema

Each tool uses typed JSON Schema. Example for `reponse_list_products`:

{
  "name": "reponse_list_products",
  "description": "Search and list products from the catalog",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query":  { "type": "string", "description": "Search query" },
      "limit":  { "type": "number", "default": 10 },
      "cursor": { "type": "string" }
    }
  }
}

Step 3 — Use in an agent workflow

With the MCP server connected, an agent can chain tools naturally:

User: "Find me a red jacket under €100 and add it to my cart"

Agent:
  1. reponse_list_products({ query: "red jacket", limit: 5 })
  2. reponse_create_cart({ currency: "EUR" })
  3. reponse_add_to_cart({ cartId: "...", variantId: "...", quantity: 1 })

Configuration reference

A2A integration

The MCP server can be used alongside the [A2A protocol](/docs/a2a-protocol) to let external agents interact with Reponse. An orchestrator agent can discover the Reponse agent card via A2A, then invoke tools through MCP for catalog and cart operations.

Troubleshooting