# mcp-server

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add nvoip/mcp-server

# Browse available tools
npx -y smithery tool list nvoip/mcp-server

# Get full schema for a tool
npx -y smithery tool get nvoip/mcp-server get_my_profile

# Call a tool
npx -y smithery tool call nvoip/mcp-server get_my_profile '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--nvoip.run.tools`

## Tools (20)

- `get_my_profile` — Show the authenticated user's public MCP profile and access scope.
- `get_mcp_access_policy` — Explain current MCP limits, plan eligibility, billing unit, and access rules.
- `get_mcp_usage_report` — Return MCP usage and overage summary for the authenticated account.
- `get_mcp_connection_guide` — Return the public connection URLs and OAuth guidance for MCP clients.
- `search_customers` — Admin-only exact customer lookup by full email, CPF/CNPJ, or account number.
- `get_customer_summary` — Return customer account summary, users, balance, and credit limit.
- `get_account_executive_summary` — Return account-level executive usage, attendance, and call insights.
- `get_attendance_summary` — Summarize attendance volume by Telefonia, WhatsApp, Chat, and Redes Sociais.
- `get_attendance_by_day` — Return daily attendance trend by channel and cost.
- `get_attendance_by_hour` — Return hourly attendance distribution by channel.
- `get_top_attendants` — Return top attendants with department and channel mix.
- `analyze_department_attendance` — Analyze attendance performance by department and attendant.
- `get_call_status_report` — Return call counts by direction and public call status labels.
- `analyze_chat_quality` — Analyze WhatsApp, Chat, and Redes Sociais service quality without returning transcripts.
- `analyze_chat_training_cases` — Return redacted case-by-case service reviews with scoring and coaching notes.
- `get_flow_status` — Inspect voicebot/chatbot schedule status and queue assignments.
- `analyze_sales_commissions` — Full-admin-only sales commission, farmer, reactivation, and downsell analysis.
- `get_admin_kpis` — Full-admin-only global Nvoip KPI payload with public indicator labels.
- `get_admin_executive_summary` — Full-admin-only monthly executive summary over global Nvoip KPIs.
- `analyze_admin_kpi_trends` — Full-admin-only trend analysis over global Nvoip KPI groups.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get nvoip/mcp-server <tool-name>
```