Blackbird MCP Server
About
It is an MCP server that connects AI assistants like Claude Desktop and Cursor with the Blackbird AI platform using API credentials. It is for developers and users who want to access Blackbird’s capabilities through an MCP-enabled client.
Details
- Author
- blackbirdai-team
- GitHub stars
- 6
- Downloads
- 316
- Categories
- Other
Jump to
- Requires Blackbird API credentials for authentication.
- Works with both Claude Desktop and Cursor.
- Runs via uv with the mcp and backoff packages.
- Configured through a simple JSON snippet in client settings.
- Supports two authentication methods: client key/secret or username/password.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Blackbird MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install uv and git, then add the server configuration to claude_desktop_config.json (Claude Desktop) or the MCP Servers settings (Cursor, v0.45.6+). Provide your Blackbird credentials (either BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY or BLACKBIRD_USERNAME and BLACKBIRD_PASSWORD) as environment variables.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"blackbird mcp server": {
"blackbird-mcp-server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"--with",
"backoff",
"mcp",
"run",
"<PATH-TO-REPO>/blackbird-mcp-server/server.py"
],
"env": {
"BLACKBIRD_CLIENT_KEY": "",
"BLACKBIRD_SECRET_KEY": "",
"BLACKBIRD_USERNAME": "",
"BLACKBIRD_PASSWORD": ""
}
}
}
}
}McpServers
{
"blackbird-mcp-server": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"--with",
"backoff",
"mcp",
"run",
"<PATH-TO-REPO>/blackbird-mcp-server/server.py"
],
"env": {
"BLACKBIRD_CLIENT_KEY": "",
"BLACKBIRD_SECRET_KEY": "",
"BLACKBIRD_USERNAME": "",
"BLACKBIRD_PASSWORD": ""
}
}
}Blackbird MCP Server
<p align="center">
</p>
<p align="center">
</p>
Prerequisites
Before you begin, ensure you have:
- Blackbird API Credentials
- You will need either:
- BLACKBIRD_USERNAME and BLACKBIRD_PASSWORD
- BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY
- Claude Desktop or Cursor
- uv
- You can verify your uv installation by running:
- uv --version
- Git installed (only needed if using Git installation method)
- On macOS: brew install git
- On Linux:
- Debian/Ubuntu: sudo apt install git
- RedHat/CentOS: sudo yum install git
- On Windows: Download Git for Windows
Blackbird MCP server installation
Configuring the Claude Desktop app
1. Clone the repository
git clone https://github.com/blackbirdai-team/blackbird-mcp-server.git
cd blackbird-mcp-server
2. Configure claude_desktop_config.json
For macOS:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
