# MCP server

Hole Monitor serves a [Model Context Protocol](https://modelcontextprotocol.io/) server at:

```text
https://api.holemonitor.live/mcp
```

Transport is Streamable HTTP, stateless. Authenticate with an API key as a bearer token: `Authorization: Bearer hm_...`. A `read` key is offered the read tools only.

Each tool wraps one REST route and returns that route's response body, so it adds nothing the [API](/docs/api/) lacks.

| Tool | Route | Scope |
| --- | --- | --- |
| `get_account` | `GET /v1/account` | read |
| `list_endpoints` | `GET /v1/endpoints` | read |
| `get_endpoint` | `GET /v1/endpoints/{id}` | read |
| `list_filters` | `GET /v1/endpoints/{id}/filters` | read |
| `preview_filter` | `POST /v1/filters/preview` | read |
| `list_deliveries` | `GET /v1/deliveries` | read |
| `get_advisory` | `GET /v1/advisories/{id}` | read |
| `create_endpoint` | `POST /v1/endpoints` | write |
| `update_endpoint` | `PATCH /v1/endpoints/{id}` | write |
| `verify_endpoint` | `POST /v1/endpoints/{id}/verify` | write |
| `send_test` | `POST /v1/endpoints/{id}/test` | write |
| `create_filter` | `POST /v1/endpoints/{id}/filters` | write |
| `replace_filters` | `PUT /v1/endpoints/{id}/filters` | write |
| `update_filter` | `PATCH /v1/filters/{id}` | write |
| `delete_filter` | `DELETE /v1/filters/{id}` | write |
| `redeliver` | `POST /v1/deliveries/{id}/redeliver` | write |

Not exposed: API keys, billing, account and endpoint deletion, secret rotation and administration.

`create_endpoint` returns the endpoint's signing secret once, into the agent's context. The agent has to put it in the receiver's secret store. A secret that passes through a model's transcript may be logged by the model's host; rotate it from the dashboard if that matters to you.

`get_advisory` returns structured content by default. With `content: "full"`, the third-party prose (`summary`, `details`) arrives as a separate content item marked as untrusted text.

The MCP server does not push advisories. Webhooks are the only notification channel.

## Client configuration

```json
{
  "mcpServers": {
    "hole-monitor": {
      "url": "https://api.holemonitor.live/mcp",
      "headers": { "Authorization": "Bearer hm_..." }
    }
  }
}
```

Clients that connect to remote servers only through OAuth cannot use this server yet.
