ARIA Customer Experience MCP Server

PyPI distribution: aria-cx-mcp · Hosted endpoint: https://mcp.aria.simplification.io/mcp · Marketing page: aria.simplification.io/mcp

Expose ARIA intelligence as Model Context Protocol tools consumable by Claude Desktop, Cursor, and any MCP-compatible client.

v1.9.5 highlight: 6 packaged Playbooks (/aria:morning-brief, /aria:churn-watch, /aria:agency-rollup, /aria:dsar-assist, /aria:bench-review, /aria:compliance-snapshot) ship as MCP prompts/*. See PLAYBOOKS.md for the full reference.

Naming note (v1.9.5 W5): the PyPI distribution name is aria-cx-mcp (renamed from aria-mcp-server to dodge a permanent collision with an unrelated clinical-research package on PyPI). The internal Python package name (aria_mcp_server) is unchanged. The new console script is aria-cx-mcp; the legacy aria-mcp-server script is retained for one minor release before removal in v1.9.6.

Connect to Claude Desktop — hosted (recommended)

Paste into claude_desktop_config.json:

{
  "mcpServers": {
    "aria": {
      "url": "https://mcp.aria.simplification.io/mcp",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer aria_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

The hosted endpoint runs on Railway with a Cloudflare-managed mcp.aria.simplification.io domain. TLS, audit-log emission, and tier gating are enforced server-side.

Connect to Claude Desktop — local install (advanced)

For offline / air-gapped use:

pip install aria-cx-mcp
aria-cx-mcp --configure

Then add to claude_desktop_config.json:

{
  "mcpServers": {
    "aria": {
      "command": "aria-cx-mcp"
    }
  }
}

Or set environment variables:

export ARIA_API_URL=https://api.aria.simplification.io
export ARIA_API_KEY=aria_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Run a hosted instance (Docker)

docker build -t aria-mcp .
docker run -p 8787:8787 \
  -e ARIA_API_URL=https://api.aria.simplification.io \
  -e ARIA_API_KEY=aria_live_xxxxx \
  aria-mcp

The container exposes /mcp (streamable-HTTP transport) and /health.

Tools (21)

Source of truth: aria_mcp_server/tools/__init__.py TOOL_SCHEMAS.

Playbooks (6)

Source of truth: aria_mcp_server/playbooks/__init__.py PLAYBOOK_DEFINITIONS.

Resources (6)

• aria://customers/{id}
• aria://conversations/{id}
• aria://flows/{id}
• aria://agents/{id}
• aria://kb/{source_id}
• aria://analytics/dashboard