Skip to main content
Glama
SalvyLTD

Salvy MCP server

Official
by SalvyLTD

Salvy MCP server

Connect your AI agent to Salvy, the business mobile carrier from Brazil. The agent can look up your company's phone lines, usage, invoices and employees, and make changes such as blocking a line or changing a plan.

This repository only describes the server. The server itself is hosted by Salvy at:

https://mcp.salvy.com.br/mcp
  • Transport: Streamable HTTP

  • Authentication: OAuth 2.0. You sign in with your Salvy dashboard account (app.salvy.com.br), and the agent can only do what that account can do in the dashboard.

  • Full guide (Portuguese): docs.salvy.com.br/mcp-guide

What you can do

  • Look into your lines. List phone lines, their data usage, SMS messages and timeline, and who uses each one.

  • Follow costs. Read invoices, the current month's estimate and cost by cost center.

  • Act on your lines. Block, unblock, cancel or create lines, add data, change plans and port numbers in.

  • Organize. Manage employees, cost centers, line groups and assets such as phones and laptops.

Anything billable (new lines, extra data, plan changes) returns a quote first and is only charged after you confirm.

Related MCP server: AgentPhone MCP Server

Example prompts

  • Which lines used the most data this month, and who uses each one?

  • How much did each cost center spend on the October invoice?

  • Block the line "Sales Team".

Setup

GitHub Copilot in VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "salvy": {
      "type": "http",
      "url": "https://mcp.salvy.com.br/mcp"
    }
  }
}

Start the server and sign in when VS Code asks.

Claude

Add Salvy from the Connectors Directory in Claude's settings, or add a custom connector with the URL above.

Gemini app

In gemini.google.com, open Settings → Connected Apps, add a custom app and paste the URL above.

Gemini CLI

gemini extensions install https://github.com/SalvyLTD/salvy-mcp

Then run /mcp auth salvy inside Gemini CLI to sign in.

Other clients

Any MCP client that supports remote servers over Streamable HTTP with OAuth works: point it at https://mcp.salvy.com.br/mcp.

Tools

Area

Tools

Companies

list_companies

Phone lines

list_phone_accounts, get_phone_account, get_phone_account_usage, get_phone_account_timeline, list_phone_account_sms_messages, update_phone_accounts, create_phone_account_group

Line actions

create_phone_accounts, block_phone_accounts, unblock_phone_accounts, cancel_phone_accounts, unschedule_phone_account_cancellations, add_data_to_phone_accounts, change_subscription_plan, list_subscription_plans

SIM shipments

list_sim_card_shipments, get_sim_card_shipment

Portability

port_number, get_portability_status

Billing

list_invoices, get_invoice, get_current_month_estimate, get_cost_by_cost_center

People

list_employees, create_employee, list_cost_centers, create_cost_center, update_cost_center

Assets

list_assets, get_asset, get_asset_summary, create_assets, update_assets, list_asset_categories, create_asset_category, delete_asset_category, list_asset_statements, send_asset_statement

Other

get_task, submit_mcp_feedback

Requirements

A company that is a Salvy customer, and a user with access to the Salvy dashboard.

Support

contato@salvy.com.br · Privacy policy · Reporting a vulnerability

Related MCP Connectors

Related MCP Servers