unifi-talk-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TALK_CA_CERT | No | Path to the console's CA certificate (PEM) | |
| TALK_BASE_URL | Yes | Console address, e.g. https://192.168.1.1 | |
| TALK_PASSWORD | Yes | Its password | |
| TALK_USERNAME | Yes | Local UniFi OS account | |
| TALK_TIMEOUT_MS | No | Per-request timeout | 30000 |
| TALK_ALLOW_WRITES | No | Enable talk_invoke | false |
| TALK_INSECURE_TLS | No | Skip TLS verification. Last resort | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| talk_statusA | Talk version and region, console summary, and service health. A good first call. |
| talk_list_callsB | Call history with caller ID, direction, status, and voicemail data. Paginated. |
| talk_get_callA | Event timeline and transcription (if enabled) for one call, by the uuid from talk_list_calls. |
| talk_list_devicesB | Talk desk phones and softphone apps with user, extension, status, SIP registration, last seen, IP, and firmware. A compact view of the devices endpoint; filter by status or kind. |
| talk_list_endpointsA | Catalog of known UniFi Talk API endpoints (users, numbers, devices, routing, voicemail, billing, and more) with their parameters. Use it to find an endpoint id for talk_get or talk_invoke. |
| talk_getB | Call any read-only Talk endpoint by id. See talk_list_endpoints for descriptions and parameters. |
| talk_invokeA | Call a Talk endpoint that changes or deletes data. Disabled unless the server runs with TALK_ALLOW_WRITES=true. Confirm with the user before calling. See talk_list_endpoints for body shapes. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Most tools have clearly distinct purposes: status, write operations, call history, call detail, devices, endpoint catalog, and generic reads. Slight overlap exists between talk_get_call (specialized call timeline) and talk_get (generic read by endpoint id), but descriptions clarify the intended use.
All tools share the talk_ prefix and mostly follow verb_noun (talk_list_calls, talk_get_call, talk_list_devices). talk_status and talk_invoke deviate slightly from the pattern, but the naming remains predictable and readable.
Seven tools is well-scoped for a UniFi Talk integration: a status check, a write dispatcher, a catalog of endpoints, and a few high-value read wrappers. Each tool earns its place without redundancy or bloat.
The combination of generic talk_get for reads, talk_invoke for writes, and talk_list_endpoints for discoverability covers the full API surface. Convenience tools for calls and devices cover the most common workflows, so there are no obvious dead ends.