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/mcp

Supported 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

  1. Go to Settings → Connectors
  2. Click Add Custom Connector
  3. Enter the MCP URL: https://mcp.distribute.you/mcp
  4. Add your API key in the Authorization header

Claude.ai / Claude Desktop

  1. Go to Settings → Connectors
  2. Click Add
  3. Enter the MCP URL: https://mcp.distribute.you/mcp
  4. 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

ToolDescription
mcpfactory_statusCheck connection status and configuration
mcpfactory_create_campaignCreate a cold email campaign
mcpfactory_list_campaignsList all your campaigns
mcpfactory_stop_campaignStop a running campaign
mcpfactory_resume_campaignResume a stopped campaign
mcpfactory_campaign_statsGet campaign statistics
mcpfactory_campaign_debugGet detailed campaign debug info
mcpfactory_list_brandsList all your brands
mcpfactory_suggest_icpSuggest 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_KEY

Get your API key at dashboard.distribute.you/api-keys

Error Handling

CodeMeaning
unauthorizedInvalid or missing API key
byok_missingRequired API key not configured in your dashboard
byok_invalidConfigured API key is invalid or expired
budget_exceededSpending limit reached
rate_limitedToo many requests