MCP Server

Connect IsDown to AI assistants like Claude using the Model Context Protocol (MCP)

Connect IsDown to AI assistants like Claude using the Model Context Protocol (MCP). Query your monitoring data ( services, incidents, and status boards directly through conversational AI.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely connect to external data sources. With IsDown's MCP server, you can ask your AI assistant questions like:

• "What services are currently experiencing issues?"

• "Show me recent incidents for AWS"

• "What's the status of my production services board?"

Prerequisites

Before setting up the MCP integration, you need:

1. A Business or Enterprise plan

2. An API key from your IsDown account

3. Claude Desktop (or another MCP-compatible AI client)

Setup Instructions

Step 1: Enable MCP Access

Contact IsDown support at [e-mail] to enable MCP access for your organization.

Step 2: Get Your API Key

1. Go to Settings → API Keys in your IsDown dashboard

2. Click Create New API Key

3. Copy the API key and store it securely—you won't be able to see it again

Step 3: Configure Claude Desktop

1. Open Claude Desktop

2. Go to Settings → Developer → Edit Config

3. Add the following configuration to your claude_desktop_config.json file:

{                                                                                       
  "mcpServers": {                                                                       
    "isdown": {                                                                         
      "command": "npx",                                                                 
      "args": [                                                                         
        "mcp-remote",                                                                   
        "https://isdown.app/mcp",                                                   
        "--header",                                                                     
        "Authorization:${AUTH_HEADER}"                                                  
      ],                                                                                
      "env": {                                                                          
        "AUTH_HEADER": "Bearer YOUR_API_KEY_HERE"                                       
      }                                                                                 
    }                                                                                   
  }                                                                                     
}                                                                                       

1. Replace YOUR_API_KEY_HERE with your actual API key

2. Save the file and restart Claude Desktop

   The mcp-remote package will be automatically installed when Claude Desktop starts. Make sure you have Node.js installed on your computer.

Step 4: Verify the Connection

After restarting Claude Desktop, you should see "isdown" listed as a connected MCP server. Try asking Claude:

• "What services am I monitoring on IsDown?"

• "Are there any ongoing incidents?"

Available Tools

The MCP server provides six read-only tools:

Tool	Description
list_services	List all services you are monitoring
get_service_status	Get the current status of a specific service
search_services	Search for services by name
list_incidents	List incidents (filter by service, status, date)
get_incident	Get detailed information about an incident
list_boards	List your status boards

Filtering by Board

You can filter services and incidents by a specific status board using the board parameter. Use list_boards first to see your available boards and their keys.

Example Queries

Here are some example questions you can ask your AI assistant:

• "List all my monitored services that are currently down"

• "What incidents happened on GitHub last week?"

• "Show me the status of services on my 'production' board"

• "Are there any major outages affecting my services right now?"

• "Get details about incident #12345"

Troubleshooting

Connection Failed

1. Verify your API key is correct

2. Ensure MCP access is enabled for your account

3. Check that you're using https:// (not http://)

4. Restart Claude Desktop after config changes

Tools Not Appearing

1. Check Claude Desktop logs for errors

2. Verify the JSON syntax in your config file

3. Ensure npx is available in your PATH

Authentication Errors

Contact [e-mail] to verify MCP is enabled for your organization.