Velip MCP Server and APIs

Your ChatGPT and Claude can now call, send WhatsApp and SMS

Connect your AI to Velip in 3 steps, no code: paste an address, sign in to your account and choose what it can do. For your own systems, use MCP with a token or the REST APIs.

Create account Talk to a specialist

Already have a Velip account? Connect in 3 steps

Velip

Claude wants to access your Velip account

Signed in as you, on your company account

APIs this app will be able to use

SMS SMS sending via the Velip platform
WhatsApp WhatsApp messages via Meta Cloud API
Email OAuth Email via Gmail or Microsoft 365, with templates and variables
Telephony Single and bulk calls, TTS voices and call lookup
Destination lists Creates phone lists for bulk campaigns

Usage is charged to your account balance. Change permissions or revoke access at any time.

Only authorize if you started this connection just now.

Cancel Authorize

Connect your AI in 3 steps

No code and no token to copy. All you need is a Velip account.

Paste the address

In the connections screen of your AI app, add a connector with this address:

https://vox20.velip.com.br/mcpserver/velip
Sign in to your Velip account

The Velip sign-in screen opens inside the app. Use the same password as on the platform.
Choose what the AI can do

Tick SMS, WhatsApp, email, telephony or destination lists and authorize. From then on, just ask in the chat.

Where to paste the address in each app

Claude.ai and Claude Desktop: Settings → Connectors → Add custom connector.
ChatGPT: In developer mode, create a connector with the address and OAuth authentication.
Claude Code: Run the command below, then use /mcp to sign in: claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip
Cursor: In mcp.json, set only the "url", without headers. Cursor asks you to sign in.

Once connected, you can view reports, create campaigns, send one-off messages and check your balance right from the chat.

What your AI can do through Velip

The same five groups from the authorization screen. You allow only the ones you want and change them anytime.

SMS

Sends SMS through the Velip platform, with the text you ask for in the chat.

Tools send_sms
WhatsApp

Sends text, media or approved templates through the official Meta API, using your own lines.

Tools send_whatsappget_wa_templatesget_wa_lines
Email

Sends email from your Gmail or Microsoft 365 account, directly or with your templates and variables.

Tools send_emaillist_email_templates
Telephony

Places calls with synthesized voice, creates, clones and checks campaigns and tracks call status.

Tools make_tts_callget_tts_voicescreate_campaignclone_campaignget_campaigns_listget_call_status
Destination lists

Creates the phone list a bulk campaign will use.

Tools create_destination_base

In practice: you ask, Velip does it

Examples of requests made in a ChatGPT or Claude chat, once connected.

Campaigns

Create a voice campaign for the 300 customers in this spreadsheet, letting them know their bill is due tomorrow.

What happens

The AI creates the destination list with the phone numbers and sets up the campaign with the message in synthesized voice.

create_destination_basecreate_campaign

Reports

How did yesterday’s campaign calls go? Build a table with answered and unanswered calls.

What happens

The AI checks the campaign and the call status and returns the analysis right in the chat.

get_campaigns_listget_call_status

Reminders

Send a WhatsApp to each patient in this spreadsheet, reminding them of tomorrow’s appointment time.

What happens

The AI picks the approved template for your line and sends one message to each contact.

get_wa_templatessend_whatsapp

Your own applications

For billing, scheduling or logistics, your agent combines channels on its own: a WhatsApp reminder, a call if there is no reply and the bill by email. Same MCP, connected with a token.

See developer instructions

The connection works both ways

MCP is the format AI agents use to talk to other systems, always with an AI on one side. Velip can be at either end.

Your AI uses Velip

ChatGPT, Claude or your own agent connects to Velip and uses its channels to reach your customers. Access is granted by sign-in (OAuth) or token, under Integrations → MCP Server.

Your AI

ChatGPT, Claude, Cursor or your own agent

Velip

MCP Server

Checks the connection permissions and runs the request

Your customers

Get the call, the WhatsApp, the SMS or the email

Velip uses your tools

Velip voice and text AI agents connect to external MCPs to fetch information or take actions. The connection is set up in the agent itself.

Velip

AI agent

Serves your customer by voice or text, including on WhatsApp

Google Calendar

Or any other system that offers MCP

Appointment booked

The agent checks open slots and books during the conversation

You decide what the AI can do

And change your mind anytime. Every connected app shows up in your account, with its own permissions.

Permissions per connection

Each app has its own allowed groups: SMS, WhatsApp, email, telephony and destination lists. Change them at any time.
Pause or disconnect

Turn a connection off to pause it, or revoke it to cut access for good. A revoked app needs a new authorization to come back.
Protected credentials

The token has 30 characters, is shown in full only once, at creation, and is stored as a bcrypt hash, never in plain text.
Masked phone numbers in the APIs

By default, queries by period or campaign return masked numbers (xxxxx877). The full number only shows if the token is set up for it.

MCP Server · Tokens

Name MCP enabled

Claude OAuth Revoke

SMSWhatsAppEmail OAuthTelephonyDestination lists
ChatGPT OAuth Revoke
Billing system a7Kq2… Revoke

For developers: MCP with a token

For your own agent or an MCP client without OAuth sign-in, create a token under Integrations → MCP Server and choose its permissions.

Address: https://vox20.velip.com.br/mcpserver/velip
Transport: Streamable HTTP (JSON-RPC 2.0)
Authentication: Authorization: Bearer YOUR_TOKEN

The full 30-character token is shown only at creation. If you lose it, revoke it and create another one.

Add it to the project .cursor/mcp.json (or the global one, at ~/.cursor/mcp.json) and reload Cursor.

{
  "mcpServers": {
    "velip": {
      "url": "https://vox20.velip.com.br/mcpserver/velip",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Run it in the terminal, in the project folder. Then check with "claude mcp list".

claude mcp add --transport http velip https://vox20.velip.com.br/mcpserver/velip --header "Authorization: Bearer YOUR_TOKEN"

Add it to claude_desktop_config.json (Settings → Developer → Edit config) and restart the app. Requires Node.js 18 or later.

{
  "mcpServers": {
    "velip": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://vox20.velip.com.br/mcpserver/velip",
        "--header",
        "Authorization:${VELIP_AUTH}"
      ],
      "env": {
        "VELIP_AUTH": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Quick test: lists the tools allowed for this token. Only the groups enabled in its permissions show up.

curl -X POST 'https://vox20.velip.com.br/mcpserver/velip' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

REST APIs for your system

No AI in between: your CRM, ERP or app calls Velip directly. Create the token under Integrations → API Tokens.

Examples in PythonPHPNode.jscURLJava

What the APIs do

Calls with synthesized voice or recorded audio

MakeTTSCallPlayAudioFileCreateAudioFileGetTTSVoices
Transfer to a human agent
Call recordings
SMS sending

MakeSMS
WhatsApp and templates

MakeWhatsappGetWATemplatesCreateWhatsappTemplateCheckTemplateStatusValidateWhatsAppNumber
Instagram and Messenger

MakeInstagramMakeMessenger
Email from your Gmail or Microsoft 365 account

SendEmailOAuth
Campaigns and destination lists

CreateCampaignChangeCampaignGetCampaignsListCreateDestinationBase
Call status and reports

GetCallStatus
Service queues

CreateCenterQueueGetCenterQueues
Browser calls (WebRTC)

GetWebRTC

Example: call with synthesized voice

curl --location --request POST 'https://vox.velip.com.br/api/v2/MakeTTSCall' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "type": "0",
    "content": "tf185409063",
    "priority": "0",
    "dest": "5511999999999",
    "nome": "Maria Silva"
  }'

The API also accepts HTTP Basic authentication, with username and password.

Documentation

Common uses

Voice alerts and notices

Your system places a call when something happens: a delayed order, a confirmed payment, an on-call shift.

Verification codes

Send the access code (2FA) by SMS or by phone call, straight from your login.

Calls from your website

A call button or voicebot on your website and app, using the Velip WebRTC connection.

Customer and courier without exposing numbers

Connect customer and courier through a masked-number call: neither one sees the other’s phone.

Frequently asked questions

Do I need to code to connect ChatGPT or Claude?

No. With sign-in (OAuth), you just paste the address into the app, sign in to your Velip account and choose the permissions.

Does what the AI does use my account balance?

Yes. What the AI sends goes through the Velip platform and uses your account balance, like any other send.

Can I connect more than one app?

Yes. Each app (Claude, ChatGPT, Cursor or your own system) becomes a separate connection with its own permissions, and can be paused or revoked without affecting the others.

Does the token expire?

No. The token works until you revoke it under Integrations → MCP Server. If you lose it, revoke it and create another one: it is shown in full only at creation.

Do I need to install anything?

Not for Claude.ai, ChatGPT, Claude Code or Cursor. Only Claude Desktop set up with a token needs Node.js 18 or later.

What is the difference between MCP and the REST APIs?

MCP is made for AI agents: the AI finds out on its own what it can do and picks the action. The REST APIs are for systems you program, like a CRM or ERP, with each call defined in the code.

Velip ecosystem