MCP Usage

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. MCP Factory provides a suite of DFY automation tools accessible via MCP.

Supported Clients

• Claude Desktop - Anthropic's desktop app
• Cursor - AI-powered IDE
• Cline - VS Code extension
• Any MCP-compatible client

Installation

Claude Desktop

Add to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sales-outreach": {
      "command": "npx",
      "args": ["@mcpfactory/sales-outreach"],
      "env": {
        "MCPFACTORY_API_KEY": "mcpf_live_xxxx"
      }
    }
  }
}

Cursor

Add to your .cursor/mcp.json in your project or globally:

{
  "mcpServers": {
    "sales-outreach": {
      "command": "npx",
      "args": ["@mcpfactory/sales-outreach"],
      "env": {
        "MCPFACTORY_API_KEY": "mcpf_live_xxxx"
      }
    }
  }
}

Cline (VS Code)

Open Cline settings and add the MCP server configuration.

Common Parameters

All MCP Factory tools share these common parameters:

Budget Control

{
  "budget": {
    "max_daily_usd": 10,      // Daily BYOK spend limit
    "max_weekly_usd": 50,     // Weekly limit
    "max_monthly_usd": 200    // Monthly limit
  }
}

Schedule

{
  "schedule": {
    "frequency": "daily",     // "daily" | "weekly" | "once"
    "trial_days": 5,          // Run for N days then pause
    "start_date": "2026-02-01",
    "end_date": "2026-02-28"
  }
}

Reporting

{
  "reporting": {
    "frequency": "daily",     // "daily" | "weekly" | "realtime"
    "email": "you@company.com",
    "whatsapp": "+1234567890",
    "webhook_url": "https://..."
  }
}

Natural Language Usage

You don't need to write JSON. Just describe what you want in plain language:

"Launch a cold email campaign for acme.com 
targeting CTOs at tech startups. 
Budget: $10/day max. 
Run for 5 days as a trial. 
Send me a daily report at ceo@acme.com."

The AI assistant will translate this to the appropriate tool call.

Error Handling

MCP Factory returns structured errors:

{
  "error": {
    "code": "budget_exceeded",
    "message": "Daily budget of $10 has been reached",
    "details": {
      "spent_today": 10.23,
      "limit": 10.00
    }
  }
}

Common Error Codes

Best Practices

1. Start with a trial - Use trial_days: 5 to test before committing
2. Set budget limits - Always configure max spend to avoid surprises
3. Enable reporting - Get daily updates on campaign performance
4. Check benchmarks - Use get_stats to compare against community averages