Skip to main content
AI Assistant

MCP Tools Reference

Complete reference of all tools available through the BlueRockTEL AI Assistant and MCP server, with required permissions and write operation flags.

Tool Catalogue

The table below lists every tool exposed by the BlueRockTEL MCP server. Tools marked Write: Yes modify data. When using the in-app AI Assistant, write operations require your explicit approval before they execute (see the approval flow). When using an external MCP client (Claude, ChatGPT, Grok), confirmation is handled by that client's own settings.

Ticket Tools

Require ticket read/write permissions.

Tool Description Write
list_tickets List and filter support tickets by status, assignee, or category; filter to your own tickets —
get_ticket Get full ticket details including all replies —
update_ticket Update ticket status, assignee, or category Yes
reply_to_ticket Post a reply or internal note on a ticket Yes

Knowledge Base Tools

Require knowledge base read/write permissions.

Tool Description Write
get_knowledge_article Retrieve a knowledge base article by ID with full content —
create_knowledge_article Create a new knowledge base article Yes
update_knowledge_article Update an existing knowledge base article Yes

CRM Tools

Require CRM read permissions.

Tool Description Write
list_customers List customer records with optional filters —
get_customer Get a customer record by ID —
list_contacts List contact records —
get_contact Get a contact record by ID —
list_invoices List invoice records —
get_invoice Get an invoice record by ID —
list_prospects List prospect records —
get_prospect Get a prospect record by ID —
list_customer_files List customer file records with telephony lines —
get_customer_file Get a customer file record by ID —

Catalog Tools

Always present, no specific permission required.

Tool Description Write
search_tools Search the tool catalogue by keyword —
execute_tools Execute tools by name —

Permissions

Tool access depends on the permissions of the authenticated user. If a tool is listed here but not available in a session, verify that the user account has the corresponding permission in Configuration → Users.