Zammad MCP Server — Tools Reference

Complete list of MCP tools, prompts, and resources exposed by the Zammad MCP Server.

Tools Reference

Tools are grouped by domain. Names match what MCP clients display. Permission requirements follow Configuration — delete tools are often denied in agent configs.

System

Tool	Description
`health_check`	Verify Zammad API connectivity
`get_server_info`	Zammad version and server metadata
`get_allowed_tools`	List tools available under current access policy

Tickets

Tool	Description
`get_ticket`	Ticket details by ID
`search_tickets`	Search with filters (state, group, query, etc.)
`create_ticket`	Create a new ticket
`update_ticket`	Update title, state, priority, group, owner
`delete_ticket`	Delete ticket (admin, usually denied)
`get_ticket_articles`	Messages / articles on a ticket
`create_article`	Add customer note, agent reply, or internal note
`get_ticket_stats`	Aggregated metrics for a period
`get_ticket_states`	Available ticket states
`get_priorities`	Priority levels
`list_ticket_tags`	Tags on a ticket
`add_ticket_tag`	Add a tag
`remove_ticket_tag`	Remove a tag
`get_article_attachment`	Download attachment (base64 or text)
`link_tickets`	Link two tickets
`merge_tickets`	Merge source into target (admin)
`summarize_ticket`	Plain-text thread, tags, last customer/agent msg

Users

Tool	Description
`get_user`	User profile by ID
`search_users`	Find users by query
`create_user`	Create user
`update_user`	Update user fields
`delete_user`	Delete user (admin, usually denied)
`get_current_user`	Authenticated API user

Organizations

Tool	Description
`get_organization`	Organization by ID
`search_organizations`	Search organizations
`create_organization`	Create organization
`update_organization`	Update organization
`delete_organization`	Delete organization (admin, usually denied)

Groups

Tool	Description
`get_group`	Group by ID
`list_groups`	All groups visible to the token
`create_group`	Create group (when permitted)

Tags (catalog)

Tool	Description
`list_tags`	Admin tag catalog

MCP prompts (built-in)

Prompt	Purpose
`ticket_summary_prompt`	Structured summary of a ticket thread
`customer_communication_prompt`	Draft professional customer-facing text
`escalation_analysis_prompt`	Escalation / overdue analysis
`analyze_ticket`	History, tags, and SLA hints
`draft_response`	Locale-aware internal or public reply
`triage_queue`	Prioritize open tickets in a group
`escalation_summary`	Pending-close / overdue briefing

Invoke prompts through clients that support MCP prompts, or ask the model to use the corresponding workflow.

MCP resources

URI pattern	Content
`zammad://ticket/{id}`	Ticket snapshot for context
`zammad://user/{id}`	User snapshot
`zammad://config/states`	Ticket states reference
`zammad://config/priorities`	Priority reference
`zammad://organization/{id}`	Organization snapshot

Zammad API mapping

Each tool wraps the official Zammad REST API via zammad-py. For field-level API details see Zammad API documentation.

Implementation source: server.py on GitHub.

Examples

Search query syntax

search_tickets accepts Zammad search syntax:

state.name:open AND group.name:Support
priority.name:3 high AND owner.email:agent@example.com
customer.email:jane@example.com

Tag a ticket after search

search_tickets → pick id
add_ticket_tag(ticket_id, "escalated")
summarize_ticket(ticket_id) for context before replying

See Agent Workflows for end-to-end prompts.

Attachment upload shape

When creating an article with attachments, each item needs:

{
  "filename": "notes.txt",
  "data": "<base64-encoded bytes>",
  "mime_type": "text/plain"
}

Permission quick reference

Tool	Minimum permission
`summarize_ticket`	READ
`add_ticket_tag`	WRITE
`link_tickets`	WRITE
`merge_tickets`	ADMIN
`delete_ticket`	ADMIN (usually denied)