Skip to content
Back to search

avarole-mcp

An MCP server for Avarole. It lets Claude, Cursor and other MCP clients look at your Avarole account and work your support queue:

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sbaig3229--avarole-mcp/badge.svg)](/listings/sbaig3229--avarole-mcp)

HTML

<a href="/listings/sbaig3229--avarole-mcp"><img src="/api/listings/sbaig3229--avarole-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines
  1. <!-- mcp-name: io.github.Sbaig3229/avarole-mcp -->
  2. # avarole-mcp
  3. An [MCP](https://modelcontextprotocol.io) server for [Avarole](https://avarole.com). It lets Claude, Cursor and other
  4. MCP clients look at your Avarole account and work your support queue:
  5. - **Agents**: list them (and the ready-made templates), read their instructions and settings, and (if you allow it) create
  6. an agent, or change its instructions, name, voice, greeting, languages and session limit.
  7. - **Calls**: recent calls with length, sentiment, rating and a summary; totals for the last N days.
  8. - **Support tickets**: list and filter them (open, unassigned, by person, by priority, by words), read a whole
  9. conversation, see who is holding how many, and (if you allow it) change status, priority, assignee and tags, add
  10. private notes, and reply to the customer.
  11. Ask things like *"Which urgent tickets have nobody on them?"*, *"Summarise yesterday's calls that went badly"* or
  12. *"Assign ticket 412 to Sue and add a note that I called the customer"* or *"Create a billing support agent from the
  13. support template, greeting callers in English and Spanish"*.
  14. ## Set it up
  15. You need an **account API key**: in Avarole open **Developer → API keys → Create key**. (Not an agent's embed key,
  16. which is meant for websites and is refused here.)
  17. **Claude Desktop** (`claude_desktop_config.json`) and **Cursor** (`~/.cursor/mcp.json`):
  18. ```json
  19. {
  20. "mcpServers": {
  21. "avarole": {
  22. "command": "uvx",
  23. "args": ["avarole-mcp"],
  24. "env": { "AVAROLE_API_KEY": "sk_..." }
  25. }
  26. }
  27. }
  28. ```
  29. **Claude Code**:
  30. ```bash
  31. claude mcp add avarole --env AVAROLE_API_KEY=sk_... -- uvx avarole-mcp
  32. ```
  33. (`uvx` comes with [uv](https://docs.astral.sh/uv/). Or `pip install avarole-mcp` and use the command `avarole-mcp`.)
  34. ## It reads by default
  35. | Setting | What it turns on |
  36. |---|---|
  37. | nothing | Reading: agents, calls, tickets, workload, statistics. |
  38. | `AVAROLE_MCP_WRITE=1` (or `--write`) | Changing: update a ticket, add a private note, create or change an agent. |
  39. | `AVAROLE_MCP_REPLIES=1` (or `--replies`, needs write) | **Emailing customers** from a ticket. Off unless you ask for it. |
  40. Add the setting to the `env` block above. Tools that change things say so in their description, and clients such as
  41. Claude ask you before running them.
  42. ## Safety
  43. - Changing an agent changes how it talks to callers straight away. Avarole silently drops values it cannot use (such as a
  44. language it does not speak), so the tool checks what was saved, puts back anything that was refused and says which
  45. values did not take.
  46. - The key is only sent to Avarole, in a header. It is never put in a URL, a result or a log, and credentials in an
  47. agent's settings are never shown.
  48. - Ticket and call text comes from customers. The assistant is told to treat it as data. Keep replies off unless you
  49. want them, and read what the assistant is about to send.
  50. - An account API key can do everything the API allows for your account, so keep it private and revoke it on the
  51. Developer page if it leaks.
  52. - The tool results go to the AI service you use, so only connect it to accounts whose data you are happy to share with it.
  53. ## Tools
  54. `avarole_list_agents`, `avarole_get_agent`, `avarole_list_calls`, `avarole_call_stats`, `avarole_list_tickets`,
  55. `avarole_get_ticket`, `avarole_ticket_stats`, `avarole_team_workload`, `avarole_list_team`; with write access
  56. `avarole_update_ticket`, `avarole_add_ticket_note`, `avarole_create_agent`, `avarole_update_agent`; with replies `avarole_reply_to_ticket`.
  57. ## Other settings
  58. - `AVAROLE_BASE_URL` (default `https://app.avarole.com`).
  59. - `--transport streamable-http` serves over HTTP on this machine (`127.0.0.1`) for tools that cannot start a process.
  60. It has no sign-in of its own: do not expose it to a network. Hosted use (for example by ChatGPT connectors) would
  61. need OAuth, which this version does not include.
  62. ## Development
  63. ```bash
  64. pip install -e ".[test]"
  65. pytest
  66. ```
  67. Apache-2.0. © Avarole.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.