MCP Usage
How to use distribute tools from any MCP-compatible client.
What is MCP?
The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. distribute provides a suite of automated distribution tools accessible via MCP.
MCP Endpoint
https://mcp.distribute.you/mcpSupported Clients
- ChatGPT - OpenAI's chat interface (Pro, Plus, Team, Enterprise)
- Claude.ai - Anthropic's web interface
- Claude Desktop - Anthropic's desktop app
- Claude Code - Anthropic's coding assistant
- Cursor - AI-powered IDE
- Any MCP-compatible client
Installation
ChatGPT
- Go to Settings → Connectors
- Click Add Custom Connector
- Enter the MCP URL:
https://mcp.distribute.you/mcp - Add your API key in the Authorization header
Claude.ai / Claude Desktop
- Go to Settings → Connectors
- Click Add
- Enter the MCP URL:
https://mcp.distribute.you/mcp - Configure authentication with your API key
Cursor
Add to your .cursor/mcp.json in your project or globally:
{
"mcpServers": {
"mcpfactory": {
"url": "https://mcp.distribute.you/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Claude Code
Add to your .mcp.json configuration:
{
"mcpServers": {
"mcpfactory": {
"url": "https://mcp.distribute.you/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Available Tools
| Tool | Description |
|---|---|
mcpfactory_status | Check connection status and configuration |
mcpfactory_create_campaign | Create a cold email campaign |
mcpfactory_list_campaigns | List all your campaigns |
mcpfactory_stop_campaign | Stop a running campaign |
mcpfactory_resume_campaign | Resume a stopped campaign |
mcpfactory_campaign_stats | Get campaign statistics |
mcpfactory_campaign_debug | Get detailed campaign debug info |
mcpfactory_list_brands | List all your brands |
mcpfactory_suggest_icp | Suggest ideal customer profile for a brand URL |
Natural Language Usage
You don't need to call tools directly. Just describe what you want:
"Launch a cold email campaign for acme.com
targeting CTOs at tech startups.
Budget: $10/day max.
Run for 5 days as a trial."The AI assistant will translate this to the appropriate tool calls.
Authentication
All MCP requests require your API key. Include it as a Bearer token:
Authorization: Bearer YOUR_API_KEYGet your API key at dashboard.distribute.you/api-keys
Error Handling
| Code | Meaning |
|---|---|
unauthorized | Invalid or missing API key |
byok_missing | Required API key not configured in your dashboard |
byok_invalid | Configured API key is invalid or expired |
budget_exceeded | Spending limit reached |
rate_limited | Too many requests |