Skip to main content
Glama
Sign In
blackbirdai-team

Blackbird MCP Server

Official
by blackbirdai-team
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Blackbird MCP Server

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

Related MCP server: mcp-bitbucket

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

  1. Configure claude_desktop_config.json

For macOS:

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit 
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Alternative method using Visual Studio Code (requires VS Code to be installed)
code "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

For Windows:

code %APPDATA%\Claude\claude_desktop_config.json

Add the Blackbird server configuration:

Replace <PATH-TO-REPO> with the path where you cloned the repository. Replace the *** with your actual Blackbird credentials. Note: you only need BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY, or BLACKBIRD_USERNAME and 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": "***"
      }
    }
  }
}

Configuring Cursor

Note: Requires Cursor version 0.45.6 or higher

To set up the Blckbird MCP server in Cursor:

  1. Open Cursor Settings

  2. Navigate to Features > MCP Servers

  3. Click on the "+ Add New MCP Server" button

  4. Fill out mcp.json the same way as you would for Claude Desktop

{
  "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": "***"
      }
    }
  }
}

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers