Install MCP

One config snippet per client. Free tier, no signup, no API key.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows). Add the blue-agent server entry:

claude_desktop_config.json

{
  "mcpServers": {
    "blue-agent": {
      "url": "https://blueagent.dev/api/mcp"
    }
  }
}

Quit Claude Desktop completely and reopen. The 🔧 icon near the input shows Blue Agent connected.

Claude Code (CLI)

Terminal

claude mcp add blue-agent \
  --transport http \
  https://blueagent.dev/api/mcp

Cursor · Cline · Windsurf

These clients use the mcp-remote bridge. Add to your MCP config:

mcp.json

{
  "mcpServers": {
    "blue-agent": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://blueagent.dev/api/mcp"]
    }
  }
}

Verify it works

From any terminal — without installing anything:

curl

curl -X POST https://blueagent.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

You should see protocolVersion: "2024-11-05" and the server info. If you do, the server is reachable from your network.

Transport details

Streamable HTTP per the MCP 2025-03-26 spec
Content negotiation: Accept: application/json for JSON, text/event-stream for SSE
CORS: Access-Control-Allow-Origin: * — browser clients work
Rate limit: 100 req/min/IP (free tier)

⚠️ Old SSE-only clients

If your client requires the legacy SSE transport (separate /sse + /messages endpoints), use mcp-remote as a bridge. It speaks Streamable HTTP upstream and SSE downstream.

← PREVIOUS

Quickstart

Core concepts