Tag-record CRUD is MCP-only today. The REST equivalents for
POST/PUT/DELETE /api/v1/tags are not yet exposed. The REST Tags API covers listing tags and attaching/detaching them from transactions; tag-record management stays on the admin dashboard and these MCP tools.create_tag
Register a new tag in the system. Use when you need to setdisplay_name, color, icon, or description up front. Most of the time agents can skip this — add_transaction_tag or update_transactions with a new slug auto-creates the tag.
Parameters
Tag slug. Regex:
^[a-z0-9][a-z0-9\-:]*[a-z0-9]$. Examples: needs-review, subscription:monthly.Human-readable name.
Optional description.
CSS color used for chip rendering (e.g.
#4f46e5).Lucide icon name (e.g.
inbox).Example input
Example output
update_tag
Update a tag’s mutable fields (display_name, description, color, icon). Slug is immutable — to rename, create a new tag, bulk re-tag affected transactions, and delete the old one.
Identify the tag by UUID, short ID, or slug.
Parameters
Tag UUID, short ID, or slug.
New display name.
New description.
New color. Pass empty string to clear.
New icon. Pass empty string to clear.
Example input
Example output
delete_tag
Delete a tag. Cascades totransaction_tags — the tag is removed from every transaction it was attached to. Annotations that reference the tag keep their rows with tag_id=NULL, preserving the audit trail.
Parameters
Tag UUID, short ID, or slug.