Metadata-Version: 2.4
Name: devhelm-mcp-server
Version: 0.8.3
Summary: DevHelm MCP server — AI agent access to monitors, incidents, alerting, and more
Project-URL: Homepage, https://devhelm.io
Project-URL: Repository, https://github.com/devhelmhq/mcp-server
Project-URL: Documentation, https://docs.devhelm.io
Author-email: DevHelm <hello@devhelm.io>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-agent,devhelm,mcp,model-context-protocol,monitoring
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: devhelm>=0.7.2
Requires-Dist: fastmcp>=2.0.0
Description-Content-Type: text/markdown

# DevHelm MCP Server

[Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [DevHelm](https://devhelm.io) — gives AI coding assistants (Cursor, Claude Desktop, Windsurf, etc.) access to your uptime monitors, incidents, alerting, and more.

## Quick Start

### Hosted (recommended)

Use the hosted server at `mcp.devhelm.io`. Two connection modes:

**Bearer auth:**
```
URL: https://mcp.devhelm.io/mcp
Authorization: Bearer <your-api-token>
```

**API key in URL** (for clients that only accept a URL):
```
URL: https://mcp.devhelm.io/<your-api-token>/mcp
```

### Local (stdio)

```bash
pip install devhelm-mcp-server
export DEVHELM_API_TOKEN=your-token
devhelm-mcp-server
```

Or with `uvx` (no install required):

```bash
export DEVHELM_API_TOKEN=your-token
uvx devhelm-mcp-server
```

### Cursor / Claude Desktop

Add to your MCP config:

```json
{
  "mcpServers": {
    "devhelm": {
      "url": "https://mcp.devhelm.io/<your-api-token>/mcp"
    }
  }
}
```

## Available Tools

| Category | Tools |
|----------|-------|
| **Monitors** | list, get, create, update, delete, pause, resume, test, results, versions |
| **Incidents** | list, get, create, resolve, delete |
| **Alert Channels** | list, get, create, update, delete, test |
| **Notification Policies** | list, get, create, update, delete, test |
| **Environments** | list, get, create, update, delete |
| **Secrets** | list, create, update, delete |
| **Tags** | list, get, create, update, delete |
| **Resource Groups** | list, get, create, update, delete, add member, remove member |
| **Webhooks** | list, get, create, update, delete, test |
| **API Keys** | list, create, revoke, delete |
| **Dependencies** | list, get, track, delete |
| **Deploy Lock** | acquire, current, release, force-release |
| **Status** | overview |

## Development

```bash
uv sync
make dev          # Start with MCP Inspector (stdio)
make serve        # Start HTTP server on :8000
make test         # Run unit tests
make lint         # Check formatting
make typecheck    # Run mypy
```

## License

MIT
