@bolide-ai/mcp

Implements the ModelContextProtocol server specification to establish bidirectional communication with MCP clients (Claude, other LLM applications). Handles protocol version negotiation, capability advertisement, and message routing through stdio or HTTP transports. Uses JSON-RPC 2.0 message framing to serialize tool definitions and responses between client and server.

Exposes email campaign CRUD operations as MCP tools that LLM clients can invoke. Implements schema-based function definitions for creating campaigns with parameters like subject, body, recipient lists, and scheduling. Routes tool calls to underlying marketing platform APIs (likely Bolide's own backend or third-party services like Mailchimp/SendGrid) and returns structured campaign metadata and status.

Provides MCP tools for querying, filtering, and segmenting contact databases based on attributes (demographics, engagement history, purchase behavior). Implements parameterized filtering logic that translates natural language intent (e.g., 'high-value customers who opened emails in the last 30 days') into database queries. Returns segment metadata including size, engagement metrics, and preview samples.

Extends campaign automation to SMS and push notification channels via MCP tools. Implements channel-specific schema definitions (SMS character limits, push notification title/body constraints) and routes messages through appropriate service providers (Twilio, Firebase, etc.). Handles delivery tracking, bounce management, and opt-out compliance per channel.

Provides MCP tools for querying campaign metrics (open rates, click rates, conversion rates, revenue attribution) and generating reports. Implements aggregation logic that translates natural language queries ('Which campaigns had the highest ROI last month?') into analytics queries. Returns structured metrics with time-series data, comparisons, and trend analysis.

Provides MCP tools for storing, retrieving, and managing email/SMS/push templates. Implements template variable substitution (e.g., {{first_name}}, {{discount_code}}) with validation to ensure all required variables are provided at send time. Integrates with Claude's text generation to help draft template content and suggest personalization variables based on available contact attributes.

Provides MCP tools for defining event-triggered campaigns (e.g., 'send email when contact signs up', 'send SMS when purchase exceeds $100'). Implements trigger schema with event types, conditions, and action definitions. Routes trigger configurations to a workflow engine that listens for events and executes associated campaigns automatically. Supports complex conditions (AND/OR logic, time windows) and action chaining.

Provides MCP tools for importing contacts from external sources (CSV, API, CRM) and syncing contact data with upstream systems. Implements field mapping logic to translate external data schemas to internal contact model. Handles deduplication, validation, and conflict resolution (e.g., which system wins if email exists in both sources). Supports incremental syncs and batch imports with progress tracking.