Waroom MCP

[!CAUTION] This is still an experimental project and there are no guarantees of stability or performance. Use with caution.

This project is a Model Context Protocol (MCP) server for interacting with the Warroom API, allowing you to get various information from Warroom using a standardized protocol.

overview

The Waroom MCP Server provides a structured way to access the Waroom API endpoints, supporting a variety of functions, including retrieving incident and postmortem information.

Related MCP server: Notion MCP Server

How to use

To start the server, set the necessary environment variables:

export WAROOM_API_KEY=your_api_key

Next, run the following command:

npx @topotal/waroom-mcp

This will start the MCP server and allow you to interact with the Wateroom API through the defined tools.

Use with Claude Desktop

To use this MCP server with Claude Desktop, you do not need to run npx @topotal/waroom-mcp manually, instead add the following to the Claude Desktop configuration file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "waroom-mcp": {
      "command": "npx",
      "args": ["@topotal/waroom-mcp"],
      "env": {
        "WAROOM_API_KEY": "your-api-key"
      }
    }
  }
}

After that, start Claude Desktop as normal. If you are using nodenv or nvm you may need to specify the full path to npx command.

Available Tools

This Model Context Protocol server provides the following Waroom-related tools:

Incident Related

• waroom_get_incidents: Get a list of incidents

• waroom_get_incident_details: Get details of a specific incident

Postmortem Related

• waroom_get_postmortems: Get list of postmortems

debug

First, build the project:

npm install
npm run build

Debugging MCP servers can be difficult because they run over stdio, so for the best debugging experience we highly recommend using MCP Inspector.

You can launch MCP Inspector via npm with the following command:

npx @modelcontextprotocol/inspector "./dist/main.js"

Make sure your environment variables are configured properly.

Once launched, the Inspector will show you a URL that you can visit in your browser to start debugging.

Publish

To publish a new version of your package, follow these steps:

1. Pull the latest code from the main branch

   git checkout main
   git pull origin main

2. Build the package

   npm run build

3. Publish to npm

   npm publish

4. Push your changes to the remote repository

   git push origin main --tags

contribution

Contributions are welcome! Fork the repository and submit pull requests for improvements and bug fixes.

license

This project is licensed under the MIT License, see the LICENSE file for details.