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
4. Configure MCP in Cursor
- 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
Start Using Tools
// 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
Tool Configuration
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)
Available Tools
Bolide AI MCP provides 54 tools across 8 categories:
🚀 Project Scaffolding
scaffold_bolide_ai_project- Create bolide.ai project directory structure
📱 Utility Tools
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
🔍 Research Tools
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 workspacenotion_create_comment- Add comments to Notion pages or discussion threadsnotion_create_database- Create new Notion databases with defined property schemasnotion_create_notion_page- Create new empty pages in Notion workspacenotion_fetch_database- Fetch database structural metadata (properties, title, etc.)notion_fetch_row- Retrieve database row properties and metadatanotion_insert_row_database- Create new pages (rows) in specified databasesnotion_query_database- Query database for pages (rows) with sorting and paginationnotion_retrieve_database_property- Get details about specific database propertiesnotion_update_page- Update page properties, icon, cover, or archive statusnotion_update_row_database- Update or archive existing database rowsnotion_update_schema_database- Update database title, description, and propertiesnotion_append_block_children- Append child blocks to parent blocks or pagesnotion_fetch_notion_block- Retrieve specific blocks by UUIDnotion_fetch_notion_child_block- Get paginated list of child blocksnotion_notion_update_block- Update block content and type-specific propertiesnotion_search_notion_page- Search pages and databases by title
📋 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 Tools
diagnostic- System environment validation (debug mode only)
Research Tools
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
})
Notion Integration
Bolide AI MCP provides comprehensive Notion integration for content management and knowledge base operations. Connect to your Notion workspace through Composio authentication.
Page and Database Management
Create and manage Notion pages and databases:
// Fetch all accessible pages and databases
notion_fetch_data({
get_all: true,
page_size: 100
})
// Search for specific pages or databases
notion_search_notion_page({
query: "project documentation",
filter_value: "page",
page_size: 20
})
// Create a new page
notion_create_notion_page({
parent_id: "page-id",
title: "New Project Documentation",
icon: "📋",
cover: "https://example.com/cover-image.jpg"
})
// Create a new database
notion_create_database({
parent_id: "page-id",
title: "Project Tasks",
properties: [
{ name: "Task", type: "title" },
{ name: "Status", type: "select" },
{ name: "Priority", type: "number" },
{ name: "Due Date", type: "date" }
]
})
Content Management
Add and manage content within pages:
// Add content blocks to a page
notion_add_page_content({
parent_block_id: "page-id",
content_block: {
block_property: "paragraph",
content: "This is a new paragraph with **bold** text",
bold: false,
italic: false
}
})
// Append multiple child blocks
notion_append_block_children({
block_id: "parent-block-id",
children: [
{
type: "paragraph",
paragraph: { rich_text: [{ text: { content: "First paragraph" } }] }
},
{
type: "bulleted_list_item",
bulleted_list_item: { rich_text: [{ text: { content: "List item" } }] }
}
]
})
// Update existing block content
notion_notion_update_block({
block_id: "block-id",
block_type: "paragraph",
content: "Updated paragraph content",
additional_properties: { color: "blue_background" }
})
Database Operations
Work with Notion databases and their data:
// Get database structure and metadata
notion_fetch_database({ database_id: "database-id" })
// Query database for specific entries
notion_query_database({
database_id: "database-id",
page_size: 50,
sorts: [{ property_name: "Due Date", ascending: false }]
})
// Insert new row into database
notion_insert_row_database({
database_id: "database-id",
properties: [
{ name: "Task", type: "title", value: "Complete project setup" },
{ name: "Status", type: "select", value: "In Progress" },
{ name: "Priority", type: "number", value: "3" },
{ name: "Due Date", type: "date", value: "2024-12-31T23:59:00.000Z" }
]
})
// Update existing database row
notion_update_row_database({
row_id: "row-id",
properties: [
{ name: "Status", type: "select", value: "Completed" },
{ name: "Priority", type: "number", value: "1" }
]
})
// Update database schema
notion_update_schema_database({
database_id: "database-id",
title: "Updated Project Tasks",
properties: [
{ name: "Status", new_type: "status" },
{ name: "Old Column", remove: true }
]
})
Block and Content Retrieval
Navigate and retrieve content from Notion:
// Get specific block content
notion_fetch_notion_block({ block_id: "block-id" })
// Get child blocks of a parent
notion_fetch_notion_child_block({
block_id: "parent-block-id",
page_size: 100
})
// Get database row details
notion_fetch_row({ page_id: "row-page-id" })
// Get specific database property details
notion_retrieve_database_property({
database_id: "database-id",
property_id: "property-name-or-id"
})
Comments and Collaboration
Add comments and collaborate on content:
// Add comment to a page
notion_create_comment({
parent_page_id: "page-id",
comment: {
content: "Great work on this documentation! 👍",
bold: false,
italic: false
}
})
// Reply to existing discussion
notion_create_comment({
discussion_id: "discussion-id",
comment: {
content: "Thanks for the feedback!",
bold: false,
italic: false
}
})
Page Updates and Management
Update page properties and status:
// Update page properties
notion_update_page({
page_id: "page-id",
properties: {
"Title": { title: [{ text: { content: "Updated Page Title" } }] },
"Status": { select: { name: "Published" } }
},
icon: { emoji: "✅" },
cover: { external: { url: "https://example.com/new-cover.jpg" } }
})
// Archive a page
notion_update_page({
page_id: "page-id",
archived: 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
Selective Tool Registration
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"
}
}
Available Tool Groups
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
- Tool Reference - Comprehensive tool documentation
- Tool Options - Configuration and selective tool registration
- Contributing - Development and contribution guidelines
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
- 🐛 Report Issues
- 💬 Support
Bolide AI MCP - Streamline your marketing automation and research workflows with AI-powered tools.