MCP server
Hole Monitor serves a Model Context Protocol server at:
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 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
{
"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.