{"serverInfo":{"name":"br.com.nvoip/mcp-server","title":"Nvoip MCP Server","version":"0.2.4","description":"Secure Nvoip MCP server for customer-scoped reports, call analytics, attendance metrics, chat quality reviews, usage limits, and admin-only business intelligence.","homepage":"https://www.nvoip.com.br/mcp-server/"},"transport":{"type":"streamable-http","url":"https://mcp.nvoip.com.br/mcp"},"authentication":{"required":true,"schemes":["oauth2","bearer"],"authorizationServerMetadata":"https://api.nvoip.com.br/v2/.well-known/oauth-authorization-server","protectedResourceMetadata":"https://mcp.nvoip.com.br/.well-known/oauth-protected-resource/mcp","notes":"Use an access token issued by the Nvoip OAuth flow. Clients with refresh-token support should renew automatically instead of asking users to paste tokens."},"availability":{"customers":"Plano Pro with MCP permission enabled for the user.","resellers":"Tier IV, Tier V, or Tier VI.","administrators":"Nvoip internal administrative profiles with scoped access."},"distribution":{"chatgptApp":{"name":"Nvoip","shortDescription":"Nvoip reports, call analytics, service quality, and business insights in ChatGPT.","description":"Connect eligible Nvoip accounts to ChatGPT through MCP to ask questions about Telefonia, WhatsApp, Chat, Redes Sociais, usage, attendants, service quality, and account performance.","privacyPolicy":"https://www.nvoip.com.br/politica-de-privacidade/","termsOfUse":"https://www.nvoip.com.br/documentos/termo-de-uso.pdf","support":"https://suporte.nvoip.com.br/portal/pt/kb/articles/como-configurar-o-mcp-server-da-nvoip","oauthReadiness":{"requiredFlow":"authorization_code_pkce","dynamicClientRegistration":true,"requiredScopes":["read","mcp:read","offline_access"],"notes":"Public ChatGPT distribution requires OAuth 2.1 authorization-code with PKCE and dynamic client registration. Manual bearer tokens are suitable for developer testing only."}},"postman":{"workspace":"https://nvoip-api.postman.co/workspace/e671d01f-168a-4c38-8d0e-c217229dd61a/team-quickstart","collectionUid":"54410122-10def8b4-f7ab-4f74-ae29-8ffd0c79908c"},"smithery":{"url":"https://smithery.ai/servers/nvoip/mcp-server"}},"tools":[{"name":"get_my_profile","description":"Show the authenticated user's public MCP profile and access scope.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_mcp_access_policy","description":"Explain current MCP limits, plan eligibility, billing unit, and access rules.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_mcp_usage_report","description":"Return MCP usage, overage summary, and consumption records for the authenticated account.","inputSchema":{"type":"object","properties":{"month":{"type":"string","description":"Month in YYYY-MM format. Defaults to the current month."},"start_date":{"type":"string","description":"Optional start date in YYYY-MM-DD format for the detailed records."},"end_date":{"type":"string","description":"Optional end date in YYYY-MM-DD format for the detailed records."},"limit":{"type":"integer","description":"Maximum number of detailed records to return. Defaults to 50.","minimum":1,"maximum":500}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_mcp_connection_guide","description":"Return the public connection URLs and OAuth guidance for MCP clients.","inputSchema":{"type":"object","properties":{},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"search_customers","description":"Admin-only exact customer lookup by full email, CPF/CNPJ, or account number.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_customer_summary","description":"Return customer account summary, users, balance, and credit limit.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_account_executive_summary","description":"Return account-level executive usage, attendance, and call insights.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_attendance_summary","description":"Summarize attendance volume by Telefonia, WhatsApp, Chat, and Redes Sociais.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_attendance_by_day","description":"Return daily attendance trend by channel and cost.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_attendance_by_hour","description":"Return hourly attendance distribution by channel.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_top_attendants","description":"Return top attendants with department and channel mix.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analyze_department_attendance","description":"Analyze attendance performance by department and attendant.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_call_status_report","description":"Return call counts by direction and public call status labels.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analyze_chat_quality","description":"Analyze WhatsApp, Chat, and Redes Sociais service quality without returning transcripts.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analyze_chat_training_cases","description":"Return redacted case-by-case service reviews with scoring and coaching notes.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."},"department":{"type":"string","description":"Optional department filter such as suporte or comercial."},"limit":{"type":"integer","description":"Maximum number of cases to return.","minimum":1,"maximum":10}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_flow_status","description":"Inspect voicebot/chatbot schedule status and queue assignments.","inputSchema":{"type":"object","properties":{"email":{"type":"string","description":"Full customer account email. Partial matches are not accepted."},"cpfcnpj":{"type":"string","description":"Full Brazilian CPF or CNPJ for the customer account."},"numbersip":{"type":"string","description":"Full Nvoip account extension or account number."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_call","description":"Full-admin-only action that starts one manual call by ringing the authenticated user's own extension first.","inputSchema":{"type":"object","properties":{"telefone_destino":{"type":"string","description":"Destination phone number to connect after the authenticated admin extension answers."}},"required":["telefone_destino"],"additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"analyze_sales_commissions","description":"Full-admin-only sales commission, farmer, reactivation, and downsell analysis.","inputSchema":{"type":"object","properties":{"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."},"include_atendare":{"type":"boolean","description":"Include Atendare pipeline matching when available."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_admin_kpis","description":"Full-admin-only global Nvoip KPI payload with public indicator labels.","inputSchema":{"type":"object","properties":{"command":{"type":"string","description":"Optional KPI group such as comercial, financeiro, cs, or operacional."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_admin_executive_summary","description":"Full-admin-only monthly executive summary over global Nvoip KPIs.","inputSchema":{"type":"object","properties":{"month":{"type":"string","description":"Month in YYYY-MM format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"analyze_admin_kpi_trends","description":"Full-admin-only trend analysis over global Nvoip KPI groups.","inputSchema":{"type":"object","properties":{"command":{"type":"string","description":"Optional KPI group such as comercial, financeiro, cs, or operacional."},"start_date":{"type":"string","description":"Start date in YYYY-MM-DD format."},"end_date":{"type":"string","description":"End date in YYYY-MM-DD format."}},"additionalProperties":false},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}],"resources":[],"prompts":[]}