MCP Server
Connect AI coding assistants like Cursor, Claude Code, VS Code Copilot, and Windsurf to your Enbbox project with the Model Context Protocol. 34 API tools and 5 documentation resources — no SDK installation required.
MCP Server
TL;DR — Enbbox has a native MCP server that gives AI coding assistants direct access to your project. It provides 34 API tools (workflows, subscribers, integrations, events) and 5 documentation resources. Works with Cursor, Claude Code, VS Code Copilot, and Windsurf. Setup: add one JSON config block — no package installation needed for remote mode.
The Enbbox MCP server gives AI coding assistants (Cursor, Claude Code, Windsurf, VS Code Copilot, and others) direct access to your Enbbox project — documentation, tools, and API operations — so your AI can configure workflows, manage subscribers, and trigger notifications on your behalf.
Quick Start
Remote Server (recommended)
No installation needed. Add this to your IDE's MCP configuration:
{
"mcpServers": {
"enbbox": {
"url": "https://enbbox.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_ENBBOX_API_KEY"
}
}
}
}Replace YOUR_ENBBOX_API_KEY with your API key from Settings → API Keys in the dashboard.
Local Server (stdio)
Install and run locally via npx:
npx @enbbox/mcpConfigure your IDE:
{
"mcpServers": {
"enbbox": {
"command": "npx",
"args": ["@enbbox/mcp"],
"env": {
"ENBBOX_API_KEY": "YOUR_ENBBOX_API_KEY"
}
}
}
}IDE Setup
Cursor
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"enbbox": {
"url": "https://enbbox.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_ENBBOX_API_KEY"
}
}
}
}Claude Code
claude mcp add enbbox --transport http https://enbbox.com/mcp/ \
--header "Authorization: Bearer YOUR_ENBBOX_API_KEY"VS Code / Windsurf
Add to your settings.json:
{
"mcp.servers": {
"enbbox": {
"url": "https://enbbox.com/mcp/",
"headers": {
"Authorization": "Bearer YOUR_ENBBOX_API_KEY"
}
}
}
}What's Included
Documentation Resources (5 resources)
The MCP server provides 5 LLM-optimized documentation resources that give AI assistants context about your Enbbox setup:
| Resource | URI | Content |
|---|---|---|
| Getting Started | enbbox://docs/getting-started | API setup, first workflow, first trigger |
| Concepts | enbbox://docs/concepts | All core entities explained |
| Workflows | enbbox://docs/workflows | Steps, templates, code-first patterns |
| Integrations | enbbox://docs/integrations | All providers and credential setup |
| SDK Guide | enbbox://docs/sdk | @enbbox/js, /react, /nextjs, /api usage |
API Tools (34 tools)
The MCP server exposes 34 tools covering all Enbbox API operations:
| Category | Tools | Operations |
|---|---|---|
| Events | 3 | trigger_event, trigger_broadcast, cancel_event |
| Workflows | 6 | list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow, update_workflow_status |
| Subscribers | 5 | list_subscribers, get_subscriber, create_subscriber, update_subscriber, delete_subscriber |
| Integrations | 5 | list_integrations, create_integration, update_integration, delete_integration, test_integration |
| Layouts | 4 | list_layouts, create_layout, update_layout, delete_layout |
| Projects | 3 | list_projects, get_project, update_project |
| Topics | 5 | list_topics, create_topic, delete_topic, add_subscribers_to_topic, remove_subscribers_from_topic |
| Activity | 3 | list_activity, activity_stats, activity_chart |
Example Prompts
Once connected, try asking your AI assistant:
- "Set up a welcome email workflow that sends when a user signs up"
- "List all my integrations and check which ones are active"
- "Create a new subscriber with email [email protected]"
- "Show me the activity stats for the last 7 days"
- "Add SendGrid as an email integration"
- "Create a digest workflow that batches notifications every hour"
Authentication
The MCP server uses your Enbbox API key for authentication. Generate one in the dashboard under Settings → API Keys.
| Mode | Authentication Method |
|---|---|
| Remote server | Authorization: ApiKey header |
| Local server | ENBBOX_API_KEY environment variable |
Without an API key, documentation resources are still accessible, but API tools will return authentication errors.