Bolide AI MCP
Bolide AI MCP is a comprehensive ModelContextProtocol (MCP) server that provides tools for marketing automation, content generation, research, and project management. It integrates with various AI services to streamline workflows for developers and marketers.
Features
- 🚀 Project Scaffolding - Create marketing project directories and structures
- 📱 Marketing Automation - Capture screenshots and videos using companion app
- 🤖 AI-Powered Content Generation - Generate social media posts using Gemini AI
- 🔍 Research Tools - Comprehensive research using Perplexity AI and OpenAI
- 📋 Linear Integration - Comprehensive Linear project management and issue tracking
- 💬 Slack Integration - Complete Slack workspace communication and management
- 📝 Notion Integration - Content management and knowledge base operations
- 🛠️ Diagnostic Tools - System validation and troubleshooting
Getting Started
Quick Start (NPM Package)
For quick testing without local builds:
Installation
npm install -g @bolide-ai/mcp
Or use with npx (recommended):
npx --package=@bolide-ai/mcp bolide-ai-mcp
Configuration
Configure your MCP client with the following:
{
"mcpServers": {
"BolideAI": {
"command": "npx --package=@bolide-ai/mcp bolide-ai-mcp",
"env": {
"BOLIDE_AI_API_KEY": "your-api-key",
}
}
}
}
Development Setup (Local Build)
For development or local builds, follow these detailed steps:
1. Install Prerequisites
Install Node.js 22+
# Download and install from https://nodejs.org/en/download
Clone the repositories
git clone https://github.com/Bolide-AI/mcp
2. Build the MCP Server
# In the directory of the cloned repository
npm install && npm run build
- In Cursor menu select Cursor → Settings → Cursor Settings
- In the opened window select Tools & Integrations
- Click New MCP Server
- Insert the MCP server configuration, replacing:
<PATH TO MCP DIRECTORY> with the path to the MCP directory<BOLIDE_AI_API_TOKEN> with your BolideAI key (can be generated at here)
{
"mcpServers": {
"BolideAI-dev": {
"type": "stdio",
"command": "node",
"args": [
"--inspect=9999",
"<PATH TO MCP DIRECTORY>/build/index.js"
],
"env": {
"BOLIDE_AI_MCP_DEBUG": "true",
"BOLIDE_AI_API_TOKEN": "<your-api-key-here>"
}
}
}
}
- Make sure the workspace is open in Cursor
- Launch the application in the simulator
// Create a project
scaffold_bolide_ai_project()
// Perform research
use_openai_deep_research({
query: "AI trends in marketing automation 2024"
})
// Analyze screencast content
analyze_screencasts({
screencastNames: ["demo.mov"],
force: false
})
Environment Variables
BOLIDE_AI_API_TOKEN - Required for research toolsBOLIDE_AI_API_URL - Optional, defaults to https://bolide.ai/api
BOLIDE_AI_MCP_DEBUG=true - Enable diagnostic tools and detailed logging- Tool Groups - Enable specific tool categories (see Tool Options)
- Individual Tools - Enable specific tools only (see Tool Options)
Bolide AI MCP provides 38 tools across 8 categories:
🚀 Project Scaffolding
scaffold_bolide_ai_project - Create bolide.ai project directory structure
check_companion_app_status - Check companion app running statuslaunch_companion_app - Launch Companion App for marketing capturestop_companion_app - Stop running companion app instancesinstall_brew_and_ffmpeg - Install Homebrew package manager and FFmpeg
🤖 Content Generation
analyze_screencasts - Analyze screencast content using Gemini AIgenerate_gif - Convert screencast segments to GIFsenhance_audio - Extract and enhance audio from screencasts using ElevenLabs
use_perplexity - Research using Perplexity AIuse_openai_deep_research - Deep research using OpenAI o4-mini-deep-research
💬 Slack Integration
slack_fetch_conversation_history - Fetch chronological message history from Slack conversationsslack_list_all_slack_team_channels - List all channels, DMs, and group messages in workspaceslack_search_for_messages_with_query - Search messages across workspace with query modifiersslack_sends_a_message_to_a_slack_channel - Send messages to channels, DMs, or groupsslack_updates_a_slack_message - Update existing messages by channel ID and timestamp
📝 Notion Integration
notion_add_page_content - Add content blocks to Notion pages with rich formattingnotion_fetch_data - Fetch pages and databases from Notion workspace
📋 Linear Integration
linear_create_issue - Create new Linear issues with comprehensive optionslinear_update_issue - Update existing Linear issues (title, description, state, assignee, etc.)linear_create_comment - Add comments to Linear issueslinear_list_issues - List Linear issues with filtering and paginationlinear_list_cycles - Get all cycles/sprints from Linearlinear_get_cycles_by_team_id - Get team-specific cycleslinear_list_states - Get workflow states for teamslinear_list_teams - Get teams with project filteringlinear_list_projects - List all Linear projectslinear_list_users - List workspace users with pagination
diagnostic - System environment validation (debug mode only)
Perplexity AI Research
Perform quick research and information gathering:
use_perplexity({
query: "Latest trends in AI marketing automation",
search_mode: "web" // or "academic"
})
OpenAI Deep Research
Conduct comprehensive research with query enrichment:
use_openai_deep_research({
query: "Economic impact of renewable energy adoption"
})
The deep research tool:
- Enriches your query using GPT-4.1 with detailed research instructions
- Researches using o4-mini-deep-research with web search and code interpreter
- Returns both enriched instructions and comprehensive findings
Linear Project Management
Bolide AI MCP provides comprehensive Linear integration for project management and issue tracking. Connect to your Linear workspace through Composio authentication.
Issue Management
Create and manage Linear issues with full parameter support:
// Create a new issue
linear_create_issue({
project_id: "your-project-id",
team_id: "your-team-id",
title: "Fix login bug on homepage",
description: "Users report login button unresponsive after v2.3 deployment",
assignee_id: "user-id",
priority: 1, // Urgent
label_ids: ["bug-label-id", "frontend-label-id"]
})
// Update an existing issue
linear_update_issue({
issue_id: "issue-id",
state_id: "in-progress-state-id",
assignee_id: "new-assignee-id"
})
// Add a comment
linear_create_comment({
issue_id: "issue-id",
body: "## Update\n\nFixed the authentication flow. Ready for testing."
})
Project Organization
List and organize your Linear workspace:
// Get all projects
linear_list_projects()
// Get teams for a project
linear_list_teams({ project_id: "project-id" })
// Get workflow states for a team
linear_list_states({ team_id: "team-id" })
// Get cycles/sprints
linear_list_cycles()
linear_get_cycles_by_team_id({ team_id: "team-id" })
Issue Tracking
List and filter issues across your workspace:
// List recent issues
linear_list_issues({ first: 20 })
// Filter by project
linear_list_issues({
project_id: "project-id",
first: 50
})
// Filter by assignee
linear_list_issues({
assignee_id: "user-id",
first: 25
})
Slack Integration
Bolide AI MCP provides comprehensive Slack integration for workspace communication and management. Connect to your Slack workspace through Composio authentication.
Channel and Workspace Management
List and explore your Slack workspace:
// List all channels (public, private, DMs, group messages)
slack_list_all_slack_team_channels({
types: "public_channel,private_channel,mpim,im",
limit: 50
})
// Filter channels by name
slack_list_all_slack_team_channels({
channel_name: "development",
types: "public_channel,private_channel"
})
// Exclude archived channels
slack_list_all_slack_team_channels({
exclude_archived: true,
limit: 100
})
Message Management
Send and update messages with rich formatting:
// Send a simple text message
slack_sends_a_message_to_a_slack_channel({
channel: "#general",
text: "Hello team! 👋"
})
// Send message with Slack markdown formatting
slack_sends_a_message_to_a_slack_channel({
channel: "#development",
text: "*Important:* Please review the new deployment process\n• Step 1: Run tests\n• Step 2: Deploy to staging\n• Step 3: Get approval"
})
// Send threaded reply
slack_sends_a_message_to_a_slack_channel({
channel: "#general",
text: "This is a reply to the discussion",
thread_ts: "1234567890.123456"
})
// Update an existing message
slack_updates_a_slack_message({
channel: "#general",
ts: "1234567890.123456",
text: "Updated message content with *bold* text"
})
Message Search and History
Search and retrieve conversation history:
// Search for messages across workspace
slack_search_for_messages_with_query({
query: "deployment failed",
count: 20,
sort: "timestamp"
})
// Search with modifiers
slack_search_for_messages_with_query({
query: "in:#development from:@john has:link",
count: 10
})
// Search by date range
slack_search_for_messages_with_query({
query: "bug report before:2024-01-15",
count: 25
})
// Fetch conversation history
slack_fetch_conversation_history({
channel: "C1234567890", // Channel ID
limit: 100
})
// Fetch history with time range
slack_fetch_conversation_history({
channel: "C1234567890",
oldest: "1640995200.000000", // Unix timestamp
latest: "1641081600.000000",
limit: 50
})
Advanced Messaging Features
Utilize advanced Slack features:
// Send message with custom bot appearance
slack_sends_a_message_to_a_slack_channel({
channel: "#announcements",
text: "System maintenance completed successfully",
username: "System Bot",
icon_emoji: ":robot_face:"
})
// Send message with link unfurling
slack_sends_a_message_to_a_slack_channel({
channel: "#sharing",
text: "Check out this article: https://example.com/article",
unfurl_links: true,
unfurl_media: true
})
// Send message and broadcast to channel (for threaded replies)
slack_sends_a_message_to_a_slack_channel({
channel: "#general",
text: "Important update for everyone",
thread_ts: "1234567890.123456",
reply_broadcast: true
})
Common Workflows
Complete Marketing Content Creation
- Set up project structure:
scaffold_bolide_ai_project()
- Check app status and capture content:
check_companion_app_status()
launch_companion_app()
- Enhance audio quality:
enhance_audio({
screencastNames: ["demo.mov"]
})
Research Workflow
- Quick research:
use_perplexity({
query: "Your research question",
search_mode: "web"
})
- Deep research:
use_openai_deep_research({
query: "Complex research topic requiring comprehensive analysis"
})
Configuration Options
Enable only the tools you need to optimize performance:
{
"env": {
"BOLIDE_AI_MCP_GROUP_RESEARCH": "true",
"BOLIDE_AI_MCP_GROUP_CONTENT_GENERATORS": "true",
"BOLIDE_AI_API_TOKEN": "your-api-key"
}
}
BOLIDE_AI_MCP_GROUP_LAUNCH - Launch and utility toolsBOLIDE_AI_MCP_GROUP_SCAFFOLDING - Project scaffolding toolsBOLIDE_AI_MCP_GROUP_CONTENT_GENERATORS - Content generation toolsBOLIDE_AI_MCP_GROUP_RESEARCH - Research and information gathering toolsBOLIDE_AI_MCP_GROUP_SLACK - Slack integration toolsBOLIDE_AI_MCP_GROUP_LINEAR - Linear project management toolsBOLIDE_AI_MCP_GROUP_NOTION - Notion integration toolsBOLIDE_AI_MCP_GROUP_DIAGNOSTICS - Diagnostic tools
Documentation
System Requirements
Dependencies
- Node.js 22+
- ffmpeg (required for GIF generation tools)
- Companion App
Troubleshooting
Enable Debug Mode
{
"env": {
"BOLIDE_AI_MCP_DEBUG": "true"
}
}
Run Diagnostics
diagnostic() // Available in debug mode
Common Issues
- Missing API Keys: Ensure all required environment variables are set
- ffmpeg Not Found: Install ffmpeg using
brew install ffmpeg - Permission Issues: Check file system permissions for project directories
Contributing
We welcome contributions! Please see our Contributing Guide for details.
License
MIT © Data Route LLC
Support
Bolide AI MCP - Streamline your marketing automation and research workflows with AI-powered tools.