PulseAgent MCP Server

MCP (Model Context Protocol) server for PulseAgent — the AI digital workforce platform. Lets you manage agents, CRM contacts, sales pipelines, and SDR trials directly from Claude Code, Cursor, or Codex.

Tools

Tool	Description
list_agents	List all AI digital workers for the current tenant
chat_with_agent	Send a message to an agent and get a response
list_crm_contacts	List CRM contacts with filters (search, country, source)
create_crm_contact	Create a new CRM contact
get_pipeline_stats	Get CRM pipeline statistics (deals by stage, values)
get_trial_status	Check WhatsApp SDR trial status

Installation

pip install pulseagent-mcp-server

Or install from source:

git clone https://github.com/iPythoning/pulseagent-mcp-server.git
cd pulseagent-mcp-server
pip install -e .

Configuration

Environment Variables

Variable	Required	Default	Description
PULSEAGENT_API_TOKEN	Yes	—	Your PulseAgent JWT token
PULSEAGENT_API_URL	No	https://pulseagent.io/app/api	API base URL

Get your JWT token from PulseAgent: Settings > API Keys, or from browser DevTools (Application > Cookies > access_token).

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "pulseagent": {
      "command": "pulseagent-mcp-server",
      "env": {
        "PULSEAGENT_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "pulseagent": {
      "command": "python",
      "args": ["-m", "pulseagent_mcp.server"],
      "cwd": "/path/to/pulseagent-mcp-server/src",
      "env": {
        "PULSEAGENT_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "pulseagent": {
      "command": "pulseagent-mcp-server",
      "env": {
        "PULSEAGENT_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Codex

{
  "mcpServers": {
    "pulseagent": {
      "command": "pulseagent-mcp-server",
      "env": {
        "PULSEAGENT_API_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

Usage Examples

Once configured, you can use natural language in your AI coding assistant:

• "List my PulseAgent agents" — calls list_agents
• "Ask the SDR agent to draft a cold email for Acme Corp" — calls chat_with_agent
• "Show me all CRM contacts from Germany" — calls list_crm_contacts with country filter
• "Add a new lead: John Doe from TechCorp, john@techcorp.com" — calls create_crm_contact
• "What's my sales pipeline looking like?" — calls get_pipeline_stats
• "Check my SDR trial status" — calls get_trial_status

Development

git clone https://github.com/iPythoning/pulseagent-mcp-server.git
cd pulseagent-mcp-server
pip install -e .

# Run directly
PULSEAGENT_API_TOKEN=your-token pulseagent-mcp-server

License

MIT