AI agents (MCP)¶
Angelia is an MCP server. An agent can ask what changed upstream, what the newest version of a package is, and add a watch, with the same tokens and scopes as the REST API.
| Tool | Does | Scope |
|---|---|---|
list_watches |
one page of watches | read |
latest_version |
the greatest version of a watch, final releases unless asked otherwise | read |
events_since |
release events after a cursor, or through a named consumer | read |
add_watch |
creates a watch (create-only, never overwrites) | write |
ack_event |
moves a named consumer's cursor forward | write |
Connect a host¶
Put the connection in the client config, readable only by you:
Ask it things¶
Which of my watches had a major release this week, and what did they replace?
What is the latest stable version of
home-assistant? Is mymanifest.jsonbehind?Start watching
astral-sh/uvreleases every hour.
Keep the agent safe¶
Versions, package names and URLs come from public registries. The tool descriptions tell the model that results are data, not instructions. Also:
- give the agent a
readtoken unless it really needsadd_watchorack_event; - prefer a host that asks before calling a write tool;
- for unattended agents, use the pull API or a dispatch into a job with read-only permissions, as the Home Assistant recipe does.