SellAgent MCP Server

Access SellAgent AI tools through the Model Context Protocol (MCP).

Features

• 🤖 AI-Powered Sales Tools - Access leads, agents, campaigns, and more
• 🔌 MCP Compatible - Works with Claude Desktop, VS Code, and other MCP clients
• 🚀 Easy Setup - Single command installation with NPX
• 🔐 Secure - API key authentication
• 📦 No Dependencies - Standalone package

Quick Start

Using NPX (Recommended)

npx @sellagent/mcp-server --api-key YOUR_API_KEY

Global Installation

npm install -g @sellagent/mcp-server
sellagent-mcp --api-key YOUR_API_KEY

Claude Desktop Configuration

Add to your claude_desktop_config.json:

Using NPX

{
  "mcpServers": {
    "sellagent": {
      "command": "npx",
      "args": ["@sellagent/mcp-server", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Using Global Install

{
  "mcpServers": {
    "sellagent": {
      "command": "sellagent-mcp",
      "args": ["--api-key", "YOUR_API_KEY"]
    }
  }
}

Using Local Development

{
  "mcpServers": {
    "sellagent": {
      "command": "node",
      "args": ["/path/to/mcp/cli.js", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Configuration

Command Line Options

• -k, --api-key KEY - Your SellAgent API key (required)
• -u, --base-url URL - Custom API base URL (default: https://server.sellagent.ai)
• -v, --verbose - Enable verbose logging
• -h, --help - Show help message

Environment Variables

Create a .env file or set environment variables:

SELLAGENT_API_KEY=your_api_key_here
SELLAGENT_BASE_URL=https://server.sellagent.ai  # optional

Available Tools

Lead Management

• sellagent_get_all_leads - Fetch all leads with filtering
• sellagent_get_lead - Get a specific lead by ID
• sellagent_create_lead - Create a new lead
• sellagent_update_lead - Update lead information
• sellagent_delete_lead - Delete a lead

Agent Management

• sellagent_get_all_agents - List all AI agents
• sellagent_get_agent - Get agent details
• sellagent_create_agent - Create new AI agent
• sellagent_update_agent - Update agent configuration
• sellagent_delete_agent - Delete an agent

Campaign Management

• sellagent_get_all_campaigns - List all campaigns
• sellagent_get_campaign - Get campaign details
• sellagent_create_campaign - Create new campaign
• sellagent_update_campaign - Update campaign
• sellagent_delete_campaign - Delete campaign

Phone & Communication

• sellagent_get_phone_numbers - List available phone numbers
• sellagent_make_call - Initiate phone call
• sellagent_get_call_logs - Retrieve call history
• sellagent_send_sms - Send SMS message

Email Tools (if Gmail connected)

• gmail_send_email - Send email via Gmail
• gmail_search_emails - Search Gmail inbox
• gmail_get_email - Get email details

Calendar Tools (if Google Calendar connected)

• calendar_create_event - Create calendar event
• calendar_list_events - List calendar events
• calendar_update_event - Update event
• calendar_delete_event - Delete event

Usage Examples

In Claude Desktop

After configuring Claude Desktop, you can use natural language:

"Show me all leads from the last week"
"Create a new lead for John Doe at Acme Corp"
"Start a phone call campaign for hot leads"
"Schedule a follow-up meeting for tomorrow at 2 PM"

Tool Authentication

All tools require authentication. When using tools, provide your auth in the request:

{
  "auth": {
    "type": "apiKey",
    "key": "your_api_key_here"
  }
}

Or use bearer token for user-specific operations:

{
  "auth": {
    "type": "bearer",
    "token": "your_jwt_token_here"
  }
}

Troubleshooting

API Key Issues

• Ensure your API key is valid and active
• Check if the key has proper permissions
• Try using environment variable instead of CLI argument

Connection Problems

• Verify your internet connection
• Check if the base URL is correct
• Use --verbose flag for detailed logs

Claude Desktop Issues

• Restart Claude Desktop after config changes
• Check the config file path is correct
• Ensure NPX is available in your PATH

Authentication Errors

• Make sure to include the auth object in every tool call
• Verify your API key is correct
• Check if the API key has the necessary permissions

Security

• API keys are never stored or logged
• All communications use HTTPS
• Minimal data is retained in memory
• No telemetry or tracking

Development

Local Testing

# Clone the repository
git clone https://github.com/sellagent/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Edit .env with your API key

# Run tests
npm test

# Start locally
npm start

Publishing Updates

# Update version
npm version patch|minor|major

# Publish to NPM
npm publish

Support

• 📧 Email: [email protected]
• 📚 Documentation: https://docs.sellagent.ai
• 🐛 Issues: https://github.com/sellagent/mcp-server/issues

License

MIT © SellAgent AI Team