Metadata-Version: 2.4
Name: aria-cx-mcp
Version: 1.9.5.post3
Summary: ARIA Customer Experience MCP Server — connect ARIA to Claude Desktop, Cursor, and other MCP-compatible clients
Author: Simplification.io
License: Proprietary — Simplification.io
Project-URL: Homepage, https://aria.simplification.io/mcp
Project-URL: Documentation, https://docs.simplification.io/integrations/claude-desktop
Project-URL: Source, https://github.com/simplification-io/aria
Project-URL: Bug Tracker, https://github.com/simplification-io/aria/issues
Keywords: aria,mcp,model-context-protocol,claude,agents
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx<1.0,>=0.27.0
Requires-Dist: pydantic<3.0,>=2.10.1
Requires-Dist: mcp<2.0,>=1.0.0
Requires-Dist: anyio<5.0,>=4.0
Requires-Dist: pyjwt<3.0,>=2.10.0
Provides-Extra: dev
Requires-Dist: pytest<9.0,>=7.4; extra == "dev"
Requires-Dist: pytest-asyncio<1.0,>=0.23; extra == "dev"
Requires-Dist: ruff<1.0,>=0.3; extra == "dev"
Requires-Dist: pip-audit<3.0,>=2.7; extra == "dev"
Requires-Dist: cyclonedx-bom<7.0,>=4.0; extra == "dev"
Requires-Dist: starlette<1.0,>=0.41; extra == "dev"
Requires-Dist: uvicorn<1.0,>=0.30; extra == "dev"
Requires-Dist: httpx<1.0,>=0.27.0; extra == "dev"
Provides-Extra: sse
Requires-Dist: starlette<1.0,>=0.41; extra == "sse"
Requires-Dist: uvicorn<1.0,>=0.30; extra == "sse"
Provides-Extra: http
Requires-Dist: starlette<1.0,>=0.41; extra == "http"
Requires-Dist: uvicorn<1.0,>=0.30; extra == "http"
Requires-Dist: asyncpg<1.0,>=0.30; extra == "http"
Provides-Extra: otel
Requires-Dist: opentelemetry-api<2.0,>=1.27; extra == "otel"
Requires-Dist: opentelemetry-sdk<2.0,>=1.27; extra == "otel"
Requires-Dist: opentelemetry-exporter-otlp<2.0,>=1.27; extra == "otel"

# ARIA Customer Experience MCP Server

PyPI distribution: [`aria-cx-mcp`](https://pypi.org/project/aria-cx-mcp/) ·
Hosted endpoint: `https://mcp.aria.simplification.io/mcp` ·
Marketing page: [aria.simplification.io/mcp](https://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`:

```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:

```bash
pip install aria-cx-mcp
aria-cx-mcp --configure
```

Then add to `claude_desktop_config.json`:

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

Or set environment variables:

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

## Run a hosted instance (Docker)

```bash
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`.

| # | Tool | Description |
|---|---|---|
| 01 | `aria_search_customers` | Search customers by name / email / external id |
| 02 | `aria_get_conversations` | List recent conversations for a customer |
| 03 | `aria_get_memory` | Retrieve customer memory record |
| 04 | `aria_classify_message` | Run the 12-step pipeline on a new message |
| 05 | `aria_search_kb` | Semantic KB search |
| 06 | `aria_get_analytics` | Analytics (volume, retention, LTV, flow perf) |
| 07 | `aria_invoke_agent` | Invoke an agent by ID with arbitrary input |
| 08 | `aria_create_flow` | Generate a draft flow from NL |
| 09 | `aria_get_suggestions` | Fetch proactive suggestions |
| 10 | `aria_get_outcomes` | Fetch bench agent outcomes |
| 11 | `aria_refine_flow` | Refine an existing flow with NL |
| 12 | `aria_configure` | Unified Copilot — configure anything via NL |
| 13 | `aria_get_agent_frameworks` | Framework badges + EU AI Act Article 13 transparency |
| 14 | `aria_explain_decision` | Per-decision explainability (powers the "Why?" button) |
| 15 | `aria_get_grounding` | Grounding citations + peer-review record |
| 16 | `aria_list_playbooks` | List marketplace Playbooks with filters |
| 17 | `aria_submit_playbook` | Submit a Playbook YAML for marketplace review |
| 18 | `aria_get_watch_status` | Proactive Watch health grid (7 dimensions) |
| 19 | `aria_list_open_alerts` | Paginated open watch alerts |
| 20 | `aria_recommend_starter_kit` | Recommend best-fit Starter Kit |
| 21 | `aria_get_attribution` | Attribution rollups (last-touch / linear / time-decay) |

## Playbooks (6)

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

| # | Playbook | Tier | Description |
|---|---|---|---|
| 1 | `aria:morning-brief` | Starter+ | Daily attention brief — customers worth attention this morning |
| 2 | `aria:churn-watch` | Starter+ | Customers crossing churn-risk thresholds with grounded citations |
| 3 | `aria:agency-rollup` | Agency / Enterprise | Cross-brand rollup of KPIs and outliers |
| 4 | `aria:dsar-assist` | Starter+ | Drafts a DSAR export bundle for legal review |
| 5 | `aria:bench-review` | Starter+ | Reviews recent agent decisions and ranks by review priority |
| 6 | `aria:compliance-snapshot` | Growth+ | Current compliance posture with honest hedges |

## Resources (6)

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