Sales Agent
AI-powered multi-agent sales email generation MCP server using OpenAI Agents SDK
Installation
npx sales-agentAsk AI about Sales Agent
Powered by Claude Β· Grounded in docs
I know everything about Sales Agent. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
π€ Sales Agent MCP Server
AI-powered multi-agent sales email generation system for Claude Desktop and Cursor.
β¨ Features
- π― Multi-Agent Generation: 3 specialized AI agents create diverse email styles
- π§ Smart Selection: AI manager evaluates and selects the best email
- βοΈ Auto-Formatting: Converts to HTML with compelling subject lines
- π§ SendGrid Integration: Direct email sending to prospects
- π§ Zero Installation: Works with
uvx- no local setup needed
π Quick Start (For Clients)
Step 1: Install uvx (One-Time Setup)
macOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell as Administrator):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Verify installation:
uvx --version
Step 2: Configure Claude Desktop
-
Open Claude Desktop config file:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
-
Add this configuration (replace with your API keys):
{
"mcpServers": {
"sales-agent": {
"command": "uvx",
"args": ["sales-agent-mcp@latest"],
"env": {
"OPENAI_API_KEY": "sk-your-openai-api-key-here",
"SENDGRID_API_KEY": "SG.your-sendgrid-api-key-here",
"SENDER_EMAIL": "your-verified@email.com",
"RECIPIENT_EMAILS": "prospect1@example.com,prospect2@example.com"
}
}
}
}
- Restart Claude Desktop
That's it! No installation, no Python, no terminal commands needed.
Step 3: Configure Cursor (Optional)
- Open Cursor Settings β Tools & Integrations β New MCP Server
- This opens
~/.cursor/mcp.json - Add the same configuration as above
π¬ Usage
In Claude Desktop or Cursor, simply ask:
Generate a sales campaign for our AI code review tool that integrates
with GitHub. Target audience is CTOs at Series A-B startups in fintech.
Claude will automatically:
- β Generate 3 different email variations
- β Evaluate and select the best one
- β Format with HTML and subject line
- β Send to your prospects via SendGrid
π Getting API Keys
OpenAI API Key
- Go to https://platform.openai.com/api-keys
- Click "Create new secret key"
- Copy the key (starts with
sk-)
SendGrid API Key
- Go to https://app.sendgrid.com/settings/api_keys
- Click "Create API Key"
- Give it "Full Access" permission
- Copy the key (starts with
SG.)
Verify Sender Email in SendGrid
- Go to https://app.sendgrid.com/settings/sender_auth
- Click "Verify a Single Sender"
- Enter your email and verify
π οΈ Available Tools
1. generate_sales_campaign
Generate complete email campaign with AI evaluation.
Example:
Generate a sales campaign for [your product] targeting [your audience]
2. send_sales_email
Format and send email via SendGrid.
Example:
Send this email: [paste email text]
3. generate_email_subject
Generate compelling subject line for any email.
Example:
Generate a subject line for this email: [paste email body]
4. convert_email_to_html
Convert plain text to professional HTML.
Example:
Convert this email to HTML: [paste plain text]
π Troubleshooting
"spawn uvx ENOENT" error
Solution: Install uvx (see Step 1 above) Still broken?: Restart your terminal/computer after installation
"Configuration Error" in Claude
Solution: Double-check your API keys in the config file Common issue: Make sure sender email is verified in SendGrid
Emails not sending
Solution: Verify your sender email in SendGrid settings Check: Make sure RECIPIENT_EMAILS are valid
"OpenAI API Key not configured"
Solution: Check that your API key starts with sk- Verify: Key is in Claude Desktop config under env
π Example Prompts
Generate Campaign
Generate a sales campaign for our AI-powered code review assistant
that catches bugs before production. Target CTOs at Series A startups
in the fintech space who care about code quality and developer velocity.
Send Custom Email
Send this email to prospects:
Hi {{name}},
I noticed your team is growing fast. Our AI code review tool
helps teams like yours catch 80% of bugs before they hit production...
[rest of email]
Just Get Subject Line
Generate a subject line for this email: [paste email body]
π Security Notes
- API keys are secure: Environment variables in Claude config are local only
- No data storage: Server doesn't store any emails or data
- SendGrid verified: Only verified sender emails can be used
- Open source: Full code available for review
π€ Support
Having issues? Need help?
- GitHub Issues: https://github.com/mmaun/sales-agent/issues
- Email: manny.maun@biznez.co.uk
- Documentation: Full docs in repository
π License
MIT License - see LICENSE file for details.
π Credits
Built with:
π― What's Next?
After successful setup, try these prompts:
- "Generate a sales campaign for [your product]"
- "Send a follow-up email to prospects who haven't responded"
- "Create 5 different subject lines for this email"
- "Convert my plain text email to HTML"
Have fun automating your sales outreach! π
