---
title: "MCP Tools Reference"
section: "AI Assistant"
order: 84
excerpt: "Complete reference of all tools available through the BlueRockTEL AI Assistant and MCP server, with required permissions and write operation flags."
alternate_slug: mcp-outils-reference
alternate_slug_de: mcp-tools-referenz
---

## 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](/en/docs/ai-assistant#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**.