Skip to main content

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:

  • Agents: list them (and the ready-made templates), read their instructions and settings, and (if you allow it) create an agent, or change its instructions, name, voice, greeting, languages and session limit.
  • Calls: recent calls with length, sentiment, rating and a summary; totals for the last N days.
  • Support tickets: list and filter them (open, unassigned, by person, by priority, by words), read a whole conversation, see who is holding how many, and (if you allow it) change status, priority, assignee and tags, add private notes, and reply to the customer.

Ask things like "Which urgent tickets have nobody on them?", "Summarise yesterday's calls that went badly" or "Assign ticket 412 to Sue and add a note that I called the customer" or "Create a billing support agent from the support template, greeting callers in English and Spanish".

Set it up

You need an account API key: in Avarole open Developer → API keys → Create key. (Not an agent's embed key, which is meant for websites and is refused here.)

Claude Desktop (claude_desktop_config.json) and Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "avarole": {
      "command": "uvx",
      "args": ["avarole-mcp"],
      "env": { "AVAROLE_API_KEY": "sk_..." }
    }
  }
}

Claude Code:

claude mcp add avarole --env AVAROLE_API_KEY=sk_... -- uvx avarole-mcp

(uvx comes with uv. Or pip install avarole-mcp and use the command avarole-mcp.)

It reads by default

Setting What it turns on
nothing Reading: agents, calls, tickets, workload, statistics.
AVAROLE_MCP_WRITE=1 (or --write) Changing: update a ticket, add a private note, create or change an agent.
AVAROLE_MCP_REPLIES=1 (or --replies, needs write) Emailing customers from a ticket. Off unless you ask for it.

Add the setting to the env block above. Tools that change things say so in their description, and clients such as Claude ask you before running them.

Safety

  • Changing an agent changes how it talks to callers straight away. Avarole silently drops values it cannot use (such as a language it does not speak), so the tool checks what was saved, puts back anything that was refused and says which values did not take.
  • 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 agent's settings are never shown.
  • Ticket and call text comes from customers. The assistant is told to treat it as data. Keep replies off unless you want them, and read what the assistant is about to send.
  • An account API key can do everything the API allows for your account, so keep it private and revoke it on the Developer page if it leaks.
  • 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.

Tools

avarole_list_agents, avarole_get_agent, avarole_list_calls, avarole_call_stats, avarole_list_tickets, avarole_get_ticket, avarole_ticket_stats, avarole_team_workload, avarole_list_team; with write access avarole_update_ticket, avarole_add_ticket_note, avarole_create_agent, avarole_update_agent; with replies avarole_reply_to_ticket.

Other settings

  • AVAROLE_BASE_URL (default https://app.avarole.com).
  • --transport streamable-http serves over HTTP on this machine (127.0.0.1) for tools that cannot start a process. It has no sign-in of its own: do not expose it to a network. Hosted use (for example by ChatGPT connectors) would need OAuth, which this version does not include.

Development

pip install -e ".[test]"
pytest

Apache-2.0. © Avarole.

Metadata

Release files for avarole-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for avarole-mcp 0.2.0
File Size Uploaded Provenance Actions
avarole_mcp-0.2.0.tar.gz 21.0 kB With provenance Details for avarole_mcp-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for avarole-mcp 0.2.0
File Interpreter ABI Platform Actions
avarole_mcp-0.2.0-py3-none-any.whl Python 3 none any Details for avarole_mcp-0.2.0-py3-none-any.whl

Total release size: 37.5 kB

Release files / avarole_mcp-0.2.0.tar.gz

Download URL avarole_mcp-0.2.0.tar.gz
Size 21.0 kB
Tags Source
SHA-256 checksum
How to use checksums
492043f88f9936d7da32e421deec7b020ddee074e0139dcd130d734977900adf
BLAKE2b-256 checksum
How to use checksums
f899312797978974d35354dcde8ff70446f893b68075f4c0f036e315cfb3d45c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / avarole_mcp-0.2.0-py3-none-any.whl

Download URL avarole_mcp-0.2.0-py3-none-any.whl
Size 16.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7dd8a3d05c2874588b10d4e27bd1ec6ce041162898b8ac02e02a195142f2c8dc
BLAKE2b-256 checksum
How to use checksums
6673cf71afcb6a01f62f06bb72d88d44d392dba8e9d76332152e1f1b392b3e47
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for avarole-mcp 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for avarole_mcp-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page