ai.shawndurrani/mcp-merchant

Official4 tools

by shawndurrani

Search-only commerce MCP server backed by Stripe (test)

ai.shawndurrani/mcp-merchant MCP Server

The ai.shawndurrani/mcp-merchant MCP server is a search-only commerce server backed by Stripe (test). It is exposed as a set of 4 tools via MCP, providing functionality specifically for commerce search use cases while relying on Stripe’s test environment.

🛠️ Key Features

Search-only commerce MCP server
Backed by Stripe (test)
4 available tools

🚀 Use Cases

Searching commerce-related data in a Stripe-backed (test) context
Integrating commerce search capabilities into MCP-based applications

⚡ Developer Benefits

Fixed tool surface area (4 tools)
Straightforward environment targeting via Stripe (test)
Suitable for search workflows without commerce write operations

Captured live from the server via tools/list.

health

Returns server health and data source

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

searchProducts

Search the product catalog by substring (Stripe test data)

Parameters3

query	string	required
page	integer	optional
pageSize	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "pageSize": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

listProducts

List products with optional query and pagination (empty query allowed)

Parameters3

query	string	optional
page	integer	optional
pageSize	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 120
    },
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0
    },
    "pageSize": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 20
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

forceRefresh

Force a refresh of the product cache (waits until complete)

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

Install

Tools (4)

healthsearchProductslistProductsforceRefresh

Configuration

Environment variables

STRIPE_SECRET_KEYrequiredsecret

Stripe secret key (test mode)

PRODUCT_LIMITdefault 100

Max products to cache

REFRESH_INTERVAL_SECdefault 600

Catalog refresh interval in seconds

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-merchant": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-merchant@0.1.3"
      ],
      "env": {
        "STRIPE_SECRET_KEY": "<YOUR_STRIPE_SECRET_KEY>",
        "PRODUCT_LIMIT": "100",
        "REFRESH_INTERVAL_SEC": "600"
      }
    }
  }
}

ai.shawndurrani/mcp-merchant MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

health

searchProducts

listProducts

forceRefresh

Install

Configuration

Related servers