MCP Server

Use SiteBrief directly from Claude, Cursor, or any MCP-compatible AI assistant. Ask about site status, incidents, and tasks in plain English.

💡

Tip:MCP (Model Context Protocol) lets AI assistants like Claude read and act on your SiteBrief data in real time — no copy-pasting, no context switching.

What you can do

Ask "Which of my sites are down right now?"
Ask "Show me all SSL certs expiring in the next 30 days"
Ask "Create a high-priority task to renew the cert for acmecorp.com"
Ask "How many incidents did I have this week?"
Ask "Give me a summary of my monitoring health"

Setup — Claude Desktop

Open your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the SiteBrief MCP server:

{
  "mcpServers": {
    "sitebrief": {
      "command": "npx",
      "args": ["-y", "@sitebrief/mcp"],
      "env": {
        "SITEBRIEF_API_KEY": "sbk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see a SiteBrief icon in the tools panel.

Setup — HTTP (advanced)

You can also call the MCP endpoint directly over HTTP from any tool or script:

# List available tools
curl -X POST https://sitebrief.net/api/mcp \
  -H "x-api-key: sbk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Get all sites
curl -X POST https://sitebrief.net/api/mcp \
  -H "x-api-key: sbk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_sites","arguments":{}}}'

Available tools

Tool	Description
get_sites	List all sites with status, uptime, and SSL expiry
get_site_status	Detailed status for a specific site by name or URL
get_incidents	Recent downtime incidents (last 7 days by default)
get_expiring_certs	SSL/domain expirations within N days
get_open_tasks	Open maintenance tasks, filterable by priority
create_task	Create a new maintenance task
get_summary	Overall health summary across all sites

Get your API key

Go to Settings → API Keys and create a new key. Use it in the SITEBRIEF_API_KEY env variable or the x-api-key header.

⚠️

Warning:Keep your API key private. Anyone with the key can read your monitoring data and create tasks.

Example conversation

You: Which of my sites are currently down?

Claude: I checked your SiteBrief account. Currently 1 site is down:
• shopexample.com — DOWN since 14:32 UTC

You: Create a high-priority task to investigate it.

Claude: Done. Created task: "Investigate shopexample.com downtime"
with High priority, linked to shopexample.com.