@hiveflow/mcp-server
Official Model Context Protocol (MCP) server for HiveFlow. Connect your AI assistants (Claude, Cursor, etc.) directly to your HiveFlow automation platform.
🚀 Quick Start
Installation
Configuration
Add to your MCP client configuration (e.g., .cursor/mcp.json
):
For Local Development
🔑 Getting Your API Key
Option 1: From HiveFlow Dashboard
- Log in to your HiveFlow dashboard
- Go to Settings > API Keys
- Generate a new API key
Option 2: From Command Line (Self-hosted)
🛠️ Available Tools
Once configured, you'll have access to these tools in your AI assistant:
Flow Management
create_flow
- Create new automation flowslist_flows
- List all your flowsget_flow
- Get details of a specific flowexecute_flow
- Execute a flow with optional inputspause_flow
- Pause an active flowresume_flow
- Resume a paused flowget_flow_executions
- Get execution history
MCP Server Management
list_mcp_servers
- List configured MCP serverscreate_mcp_server
- Register new MCP servers
📊 Available Resources
hiveflow://flows
- Access to all your flows datahiveflow://mcp-servers
- MCP servers configurationhiveflow://executions
- Flow execution history
💡 Usage Examples
Create a New Flow
List Active Flows
Execute a Flow
Get Flow Status
🔧 Configuration Options
Environment Variables
HIVEFLOW_API_KEY
- Your HiveFlow API key (required)HIVEFLOW_API_URL
- Your HiveFlow instance URL (default: https://api.hiveflow.ai)HIVEFLOW_INSTANCE_ID
- Instance ID for multi-tenant setups (optional)
Command Line Options
🏗️ Architecture
This MCP server acts as a bridge between your AI assistant and HiveFlow:
🔒 Security
- API keys are transmitted securely over HTTPS
- All requests are authenticated and authorized
- No data is stored locally by the MCP server
🐛 Troubleshooting
Common Issues
"HIVEFLOW_API_KEY is required"
- Make sure you've set the API key in your MCP configuration
- Verify the API key is valid and not expired
"Cannot connect to HiveFlow API"
- Check that your HiveFlow instance is running
- Verify the API URL is correct
- Ensure there are no firewall restrictions
"MCP server not found"
- Restart your AI assistant completely
- Verify the MCP configuration file is in the correct location
- Check that the package is installed:
npm list -g @hiveflow/mcp-server
Debug Mode
For detailed logging, set the environment variable:
📚 Documentation
🤝 Contributing
We welcome contributions! Please see our Contributing Guide for details.
📄 License
MIT License - see LICENSE file for details.
🆘 Support
Made with ❤️ by the HiveFlow team
This server cannot be installed
Connects AI assistants (Claude, Cursor, etc.) directly to HiveFlow automation platform, enabling flow management and execution through natural language commands.
Related MCP Servers
- AsecurityAlicenseAqualityEnables AI assistants to interact with the Hive blockchain through the Model Context Protocol, allowing for account info retrieval, content reading/creation, cryptocurrency transfers, and cryptographic operations.Last updated -13372TypeScriptISC License
- -securityAlicense-qualityConnects Fledge functionality to Cursor AI, allowing interaction with Fledge instances via natural language commands.Last updated -PythonMIT License
- -securityAlicense-qualityConnects Claude and other MCP-compatible AI assistants to a Coreflux MQTT broker, enabling them to discover and execute Coreflux commands for managing models, actions, rules, and routes through natural language.Last updated -2PythonApache 2.0
- -securityFlicense-qualityEnables AI assistants like Claude Desktop, Claude Code, and Cursor to interact directly with Flatfile data through 100+ API endpoints for viewing, managing, and manipulating sheets, workbooks, records, and spaces.Last updated -70TypeScript