Blackbird MCP Server

What is Blackbird MCP Server?

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.

How to use Blackbird MCP Server?

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.

Key features of Blackbird MCP Server

• 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.

Use cases of Blackbird MCP Server

• Enable Claude Desktop to interact with Blackbird AI services.
• Extend Cursor with Blackbird-powered context or actions.
• Automate Blackbird workflows through an MCP-compatible assistant.

FAQ from Blackbird MCP Server

What credentials are needed?

You need either BLACKBIRD_CLIENT_KEY and BLACKBIRD_SECRET_KEY, or BLACKBIRD_USERNAME and BLACKBIRD_PASSWORD. These are set as environment variables in the server configuration.

What runtime dependencies are required?

You need uv (install from astral.sh), git (for cloning), and either Claude Desktop or Cursor (v0.45.6+ for Cursor). The server itself uses mcp[cli] and backoff Python packages, which are handled by uv run.

How do I configure the server for Claude Desktop?

Edit claude_desktop_config.json (located in ~/Library/Application Support/Claude/ on macOS or %APPDATA%\Claude\ on Windows) by adding the blackbird-mcp-server entry with the uv command and your credentials.

Can I use Blackbird MCP Server with Cursor?

Yes. Open Cursor Settings, go to Features > MCP Servers, add a new server with the same JSON configuration as for Claude Desktop.

Where does the server store or process data?

The README does not specify; data handling depends on the Blackbird API that the server communicates with. Credentials are passed as environment variables and are not stored locally by the server.