Waroom MCP

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.

How to use

To start the server, set the necessary environment variables:

Next, run the following command:

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

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:

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:

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.