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, port numbers in, and replace a lost or broken SIM card.

• 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: Voice Logica MCP

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.

Antigravity

agy plugin install https://github.com/SalvyLTD/salvy-mcp

Then open Agent settings → Customizations and click Authenticate next to salvy.

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

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