BusinessFlowPro MCP Server

BusinessFlowPro MCP Server

An MCP (Model Context Protocol) server that enables Claude Desktop to interact with BusinessFlowPro marketing automation platform via natural language.

Features

• Campaign Management: Create, send, and schedule email campaigns
• Contact Management: Add and manage contacts and segments
• Email Templates: Create and manage reusable templates
• Landing Pages: Build and publish landing pages
• Lead Forms: Manage forms and view submissions
• Analytics: View email and campaign performance metrics
• AI Content Generation: Generate emails, subject lines, and landing pages

Installation

Using pip

cd mcp-server
pip install -e .

Using uv (recommended)

cd mcp-server
uv pip install -e .

Configuration

Environment Variables

Create a .env file or set environment variables:

BUSINESSFLOWPRO_API_URL=https://app.businessflowpro.com
BUSINESSFLOWPRO_EMAIL=your_email@company.com
BUSINESSFLOWPRO_PASSWORD=your_password

Claude Desktop Configuration

Add to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "businessflowpro": {
      "command": "python",
      "args": ["-m", "businessflowpro_mcp"],
      "env": {
        "BUSINESSFLOWPRO_API_URL": "https://app.businessflowpro.com",
        "BUSINESSFLOWPRO_EMAIL": "your_email@company.com",
        "BUSINESSFLOWPRO_PASSWORD": "your_password"
      }
    }
  }
}

Or if using uv:

{
  "mcpServers": {
    "businessflowpro": {
      "command": "uv",
      "args": ["run", "python", "-m", "businessflowpro_mcp"],
      "env": {
        "BUSINESSFLOWPRO_API_URL": "https://app.businessflowpro.com",
        "BUSINESSFLOWPRO_EMAIL": "your_email@company.com",
        "BUSINESSFLOWPRO_PASSWORD": "your_password"
      }
    }
  }
}

Available Tools

Campaign Tools

| Tool | Description | |------|-------------| | list_campaigns | List all campaigns with optional status filtering | | get_campaign | Get detailed information about a campaign | | create_campaign | Create a new email campaign | | send_campaign | Send a campaign immediately | | schedule_campaign | Schedule a campaign for future delivery |

Contact Tools

| Tool | Description | |------|-------------| | list_contacts | List contacts with search and filtering | | get_contact | Get detailed contact information | | create_contact | Create a new contact | | list_segments | List all contact segments |

Template Tools

| Tool | Description | |------|-------------| | list_templates | List all email templates | | create_template | Create a new email template |

Landing Page Tools

| Tool | Description | |------|-------------| | list_landing_pages | List all landing pages | | create_landing_page | Create a new landing page | | publish_landing_page | Publish a landing page |

Form Tools

| Tool | Description | |------|-------------| | list_forms | List all lead capture forms | | get_form_submissions | Get form submissions |

Analytics Tools

| Tool | Description | |------|-------------| | get_analytics_overview | Get platform analytics metrics |

AI Content Tools

| Tool | Description | |------|-------------| | generate_email | Generate email content using AI | | generate_subject_lines | Generate subject line variations | | generate_landing_page | Generate landing page content | | generate_campaign_sequence | Generate a multi-email drip sequence |

Example Conversations

List Draft Campaigns

You: Show me my draft campaigns
Claude: [Uses list_campaigns(status="draft")]
→ "You have 3 draft campaigns: Summer Sale, Q3 Newsletter, Product Launch"

Create an Email

You: Create an email for our summer sale targeting marketing managers
Claude: [Uses generate_email(prompt="summer sale for marketing managers")]
→ Shows generated email content

You: Create a campaign with that email
Claude: [Uses create_campaign with the generated content]
→ "Campaign created successfully..."

Check Analytics

You: What's our email performance this month?
Claude: [Uses get_analytics_overview(date_range="30d")]
→ "Open rate: 32.5%, Click rate: 8.2%, 12 campaigns sent..."

Development

Running Locally

cd mcp-server
python -m businessflowpro_mcp

Running Tests

pip install -e ".[dev]"
pytest

Security Notes

• Credentials are stored in environment variables, not in code
• Tokens are automatically refreshed before expiry
• API calls use HTTPS for secure communication
• Failed authentication attempts are logged but credentials are not exposed

Troubleshooting

"Configuration error: BusinessFlowPro credentials not configured"

Ensure you have set the BUSINESSFLOWPRO_EMAIL and BUSINESSFLOWPRO_PASSWORD environment variables.

"Authentication failed"

Check that your email and password are correct. Verify you can log in to the BusinessFlowPro web interface.

"Permission denied"

Your account may not have access to certain features. Contact your BusinessFlowPro administrator.

"Rate limit exceeded"

Wait a moment before making more requests. The server implements automatic token refresh but does not handle rate limiting retries.

License

MIT