How do I use Blackbird MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Blackbird MCP Server check this text for AI-generated content" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Blackbird MCP server installation

Configuring the Claude Desktop app

Clone the repository

git clone https://github.com/blackbirdai-team/blackbird-mcp-server.git
cd blackbird-mcp-server

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:

Open Cursor Settings
Navigate to Features > MCP Servers
Click on the "+ Add New MCP Server" button
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": "***"
      }
    }
  }
}