MCP-Integration

Voraussetzungen

• Ein Baromio-Konto mit mindestens einem konfigurierten Monitor.
• A Baromio API token: generate one under Profile → API Keys. Use a Read-only token for telemetry queries, or a Full Access token to create, update, pause, configure, and delete monitors on paid plans.
• Node.js 18+: required if you use the mcp-remote bridge for Claude Desktop. Download from nodejs.org. Verify with node -v. Not needed if you use the Connectors UI or Cursor/Windsurf.
• Ein MCP-kompatibler Client. Unterstützte Clients:

Token-Typen

Baromio uses Passport API tokens and OAuth access tokens. Two permission levels are available:

Full Access tokens carry the mcp:full ability. Read-only tokens carry the read ability. Full Access write actions require an eligible paid plan; monitor deletion also requires the exact monitor ID.

Installation

Der MCP-Server-Endpunkt lautet:

https://baromio.io/mcp

https://baromio.io/mcp

{
  "mcpServers": {
    "baromio": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://baromio.io/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

{
  "mcpServers": {
    "baromio": {
      "url": "https://baromio.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

{
  "mcpServers": {
    "baromio": {
      "serverUrl": "https://baromio.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

"baromio": {
  "serverUrl": "https://baromio.io/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_TOKEN"
  }
}

# curl: verify the Streamable HTTP endpoint
curl -s -X POST \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl-test","version":"1.0"}}}' \
  https://baromio.io/mcp

Verfügbare Tools

Baromio exposes read tools for monitor health, incidents, SSL, PageSpeed, status pages, charts, and notification channels. Paid plans can also create, edit, pause, resume, configure, and delete monitors safely.

{
  "type": "object",
  "properties": {}
}

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Production API",
    "url": "https://api.example.com",
    "status": "up",
    "type": "http",
    "check_interval": 300,
    "paused_at": null
  }
]

{
  "type": "object",
  "required": ["monitor_id"],
  "properties": {
    "monitor_id": {
      "type": "string",
      "description": "UUID of the monitor"
    },
    "period": {
      "type": "string",
      "description": "\"24h\" or \"30d\" (default: \"30d\")"
    }
  }
}

{
  "monitor_name": "Production API",
  "status": "up",
  "period": "last 30 days",
  "uptime_percentage": "99.85%",
  "average_response_time_ms": 142,
  "total_pings_analyzed": 129600, // 30d × 24h × 60min × 3 pings/min
  "total_incidents": 3
}

{
  "type": "object",
  "required": ["monitor_id"],
  "properties": {
    "monitor_id": {
      "type": "string",
      "description": "UUID of the monitor"
    }
  }
}

[
  {
    "id": 12,
    "monitor_id": "a1b2c3d4-...",
    "started_at": "2026-03-28T14:22:00.000000Z",
    "resolved_at": "2026-03-28T14:35:00.000000Z",
    "duration": 780,
    "root_cause": "Connection timeout"
  }
]

{
  "type": "object",
  "required": ["name", "url"],
  "properties": {
    "name": {
      "type": "string",
      "description": "Display name, e.g. My API"
    },
    "url": {
      "type": "string",
      "description": "Full URL, e.g. https://api.example.com"
    },
    "type": {
      "type": "string",
      "enum": ["http", "keyword"],
      "description": "Default: http"
    },
    "check_interval": {
      "type": "integer",
      "description": "Seconds between checks. Default: 300"
    },
    "timeout": {
      "type": "integer",
      "description": "Seconds before marking down. Default: 10"
    },
    "monitor_ssl": {
      "type": "boolean",
      "description": "Monitor SSL cert. Default: false"
    },
    "notify_uptime": {
      "type": "boolean",
      "description": "Email alerts. Default: true"
    },
    "monitor_domain": {
      "type": "boolean",
      "description": "Monitor domain expiry. Default: false"
    }
  }
}

Monitor created successfully.

{
  "id": "f7e6d5c4-b3a2-1098-fedc-ba9876543210",
  "name": "Staging API",
  "url": "https://staging.example.com",
  "type": "http",
  "status": "pending",
  "check_interval": 300,
  "timeout": 10,
  "monitor_ssl": false,
  "notify_uptime": true,
  "monitor_domain": false
}

{
  "type": "object",
  "required": ["monitor_id", "pause"],
  "properties": {
    "monitor_id": {
      "type": "string",
      "description": "UUID of the monitor to modify"
    },
    "pause": {
      "type": "boolean",
      "description": "true to pause, false to resume"
    }
  }
}

Monitor paused successfully.

Monitor unpaused successfully.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max incidents per monitor (1–50). Default: 10"
    }
  }
}

[
  {
    "monitor_name": "Production API",
    "monitor_id": "a1b2c3d4-...",
    "incident_id": 42,
    "started_at": "2026-03-28T14:22:00.000000Z",
    "resolved_at": "2026-03-28T14:35:00.000000Z",
    "duration": "13m 0s",
    "root_cause": "Connection timeout"
  },
  {
    "monitor_name": "Staging API",
    "monitor_id": "b2c3d4e5-...",
    "incident_id": 38,
    "started_at": "2026-03-27T09:10:00.000000Z",
    "resolved_at": "2026-03-27T09:11:30.000000Z",
    "duration": "1m 30s",
    "root_cause": "Gateway Timeout"
  }
]

Beispiel-Prompts

Kopieren Sie diese direkt in Ihren KI-Agenten. Der Agent ruft die passenden Tools automatisch auf.

Fehlerbehebung

https://baromio.io/mcp

Changelog

MCP server version: 3.22.2 · Protocol: MCP 2024-11-05 · Transport: SSE