# MCP Server

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 **<support@isdown.app>** 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:

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

4. Replace YOUR\_API\_KEY\_HERE with your actual API key
5. Save the file and restart Claude Desktop

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>The mcp-remote package will be automatically installed when Claude Desktop starts. Make sure you have Node.js installed on your computer.</p></div>

#### 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 <support@isdown.app> to verify MCP is enabled for your organization.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.isdown.app/integrations/mcp-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.