sellinger-mcp

Sellinger MCP Server

An MCP (Model Context Protocol) server that exposes Sellinger CRM operations as tools, allowing AI assistants like Claude to interact with your CRM data directly.

Setup

1. Install dependencies

cd mcp-server
npm install

2. Build

npm run build

3. Configure environment

Set the following environment variables (or pass them via your MCP client config):

Variable	Required	Description
SELLINGER_API_KEY	Yes	Your Sellinger API key (sk_live_...)
SELLINGER_TEAM_ID	Yes	Team UUID (x-team-id for all requests)
SELLINGER_BASE_URL	No	API base URL (default: https://app.sellinger.ai)

Generate an API key from Settings → Integrations → API Keys in the Sellinger dashboard.

Connecting to Claude Desktop

Add the following to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "sellinger": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "SELLINGER_API_KEY": "sk_live_your_key_here",
        "SELLINGER_TEAM_ID": "your-team-uuid",
        "SELLINGER_BASE_URL": "https://your-app.sellinger.ai"
      }
    }
  }
}

Then restart Claude Desktop.

Available Tools

list_leads

List leads with optional filters and pagination.

Parameter	Type	Description
status	string	Filter by status: NEW, ENGAGED, CONVERTED, IRRELEVANT
stage	string	Filter by pipeline stage name or ID
search	string	Search by name, company, or email
page	number	Page number (1-based, default 1)
per_page	number	Results per page (max 100, default 25)

get_lead

Retrieve a single lead by UUID.

Parameter	Type	Required	Description
id	string	Yes	UUID of the lead

create_lead

Create a new lead in the CRM.

Parameter	Type	Required	Description
first_name	string	Yes	Lead's first name
last_name	string	Yes	Lead's last name
company	string	No	Company name
title	string	No	Job title
email	string	No	Email address
phone	string	No	Phone number
linkedin_url	string	No	LinkedIn profile URL
source	string	No	Acquisition source
notes	string	No	Free-form notes

update_lead

Update fields on an existing lead. Only provided fields are changed.

Parameter	Type	Required	Description
id	string	Yes	UUID of the lead
status	string	No	New status
stage_id	string	No	Pipeline stage UUID
first_name	string	No	Updated first name
last_name	string	No	Updated last name
company	string	No	Updated company
title	string	No	Updated job title
email	string	No	Updated email
phone	string	No	Updated phone
notes	string	No	Updated notes

send_message

Send a message to a lead via a specified channel.

Parameter	Type	Required	Description
lead_id	string	Yes	UUID of the lead
channel	string	Yes	Channel: email, linkedin, whatsapp
subject	string	No	Subject line (required for email)
body	string	Yes	Message content

list_segments

List all saved segments in the CRM.

Parameter	Type	Description
include_counts	boolean	Include lead counts (default false)

get_analytics

Get a KPI dashboard summary.

Parameter	Type	Description
period	string	Time period: 7d, 30d, 90d, all (default 30d)

search_leads

Full-text search across all lead fields.

Parameter	Type	Required	Description
query	string	Yes	Search query
limit	number	No	Max results (default 10, max 50)

Development

npm run dev    # Watch mode — recompiles on change
npm run lint   # Type-check without emitting
npm run build  # Production build
npm start      # Run the server

Architecture

The server communicates over stdio using the MCP protocol. Each tool translates into an authenticated HTTP request to the Sellinger API, using the configured API key for authorization.

Claude Desktop ←→ stdio ←→ MCP Server ←→ HTTPS ←→ Sellinger API