Installation & Setup

Set up the @dealsurface/mcp-server package for your MCP client.

Prerequisites

Node.js 18+ — the MCP server runs on Node.js.
DealSurface API key — created from Settings → API Keys with read and outreach scopes.

Quick start

No install step is required. MCP clients run the server automatically via npx. Pick your client below to get started.

npx -y @dealsurface/mcp-server

Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Finding the config file on Mac

Click the Claude menu in your system menu bar (not inside the Claude window), go to Settings → Developer, then click “Edit Config” — this opens the file directly, and creates it if it doesn't exist yet.

claude_desktop_config.json

{
  "mcpServers": {
    "dealsurface": {
      "command": "npx",
      "args": ["-y", "@dealsurface/mcp-server"],
      "env": {
        "DEALSURFACE_API_KEY": "ds_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop after saving. The DealSurface tools will appear in the tools menu.

Claude Code

Set DEALSURFACE_API_KEY in your shell profile or pass it inline:

export DEALSURFACE_API_KEY="ds_live_your_key_here"

Then add DealSurface as an MCP server:

claude mcp add dealsurface -- npx @dealsurface/mcp-server

Generic MCP client

For any MCP client that supports stdio transport, configure:

{
  "name": "dealsurface",
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "@dealsurface/mcp-server"],
  "env": {
    "DEALSURFACE_API_KEY": "<your-api-key>"
  }
}

Verifying the connection

After configuring, ask your AI assistant to "list my DealSurface products." If the connection is working, it will call the list_products tool and return your product data.

Environment variables

Variable	Required	Description
`DEALSURFACE_API_KEY`	Yes	Your DealSurface API key (starts with `ds_live_`).

Keep your API key secure

Store your API key in environment variables or a secrets manager. Never hardcode it in configuration files that are committed to version control.

Package links

Overview Tool Catalog