Bluejay MCP Server - Bluejay Docs

Ask an AI assistant such as Claude Code or Cursor to create simulations, run them, and read the results for you.

Connect

Add the server to your client

Claude Code
Claude
Cursor
VS Code
Other clients

claude mcp add --transport http bluejay https://api.getbluejay.ai/mcp

Then run /mcp in Claude Code, pick bluejay, and choose Authenticate.

In Claude Desktop or claude.ai, open Settings → Connectors, choose Add custom connector, and enter https://api.getbluejay.ai/mcp as the URL.

Add this to ~/.cursor/mcp.json or .cursor/mcp.json in your project, then choose Connect next to bluejay in Cursor’s MCP settings.

{
  "mcpServers": {
    "bluejay": {
      "url": "https://api.getbluejay.ai/mcp"
    }
  }
}

Add this to .vscode/mcp.json, then choose Start above the server.

{
  "servers": {
    "bluejay": {
      "type": "http",
      "url": "https://api.getbluejay.ai/mcp"
    }
  }
}

Add a remote MCP server with the URL https://api.getbluejay.ai/mcp. If your client cannot sign in to MCP servers, use an API key.

Your browser opens Bluejay. Sign in, pick the organization and workspace, and choose Authorize.The assistant can only see and change that workspace. To disconnect, remove Bluejay from your client.

Test the connection

Ask your assistant: “List my agents.” It should return the agents in the workspace you picked.

Use an API key instead

For CI, scripts, or clients that cannot sign in, connect with an API key.

Get an API key

Open the API Keys page of the app and create a key.

Add the server with your key

Replace <your_api_key> with your API key.

Claude Code
Claude Desktop
Cursor
Windsurf
Other clients

claude mcp add --transport http bluejay https://api.getbluejay.ai/mcp \
  --header "X-API-Key: <your_api_key>"

Add this to claude_desktop_config.json, then restart Claude Desktop.

{
  "mcpServers": {
    "bluejay": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.getbluejay.ai/mcp", "--header", "X-API-Key:<your_api_key>"]
    }
  }
}

Add this to ~/.cursor/mcp.json or .cursor/mcp.json in your project.

{
  "mcpServers": {
    "bluejay": {
      "url": "https://api.getbluejay.ai/mcp",
      "headers": { "X-API-Key": "<your_api_key>" }
    }
  }
}

Add this to ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "bluejay": {
      "serverUrl": "https://api.getbluejay.ai/mcp",
      "headers": { "X-API-Key": "<your_api_key>" }
    }
  }
}

Add a remote MCP server with these values:

URL: https://api.getbluejay.ai/mcp
Header: X-API-Key: <your_api_key>

If your client cannot set a custom header, send Authorization: Bearer <your_api_key> instead.

Confirm before a change

Some tools change your agent at the provider, start long runs, or delete parts of a graph. So that none of this happens without your approval, these tools first return a preview with needs_confirmation. The assistant must show you the preview, and call the tool again with confirmed=true only after you approve. In the tool tables, these tools say “Asks for confirmation.”

​Connect

​Use an API key instead

​Confirm before a change

​Related

Connect

Use an API key instead

Confirm before a change

Related