Wavix

by wavix

Not rated
GitHub

About

Wavix is a global communications platform offering APIs for voice, SMS, 2FA, and phone numbers. Our MCP server brings these capabilities to AI agents and agentic workflows.

Details

Author
wavix
Categories
Communication, Other, API

Setup

Install Wavix in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/wavix/wavix-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

- Send transactional SMS/MMS— Ask to send a message viasms_and_mms_messages_send, returning message ID and delivery status.
- Run 2FA verification flows— Create a code withtwo_fa_verification_create, then validate it viatwo_fa_verification_check.
- Search and buy phone numbers— Find available numbers withbuy_numbers_list, add to cart viacart_add, and complete purchase withcart_checkout.
- Search call transcripts— Usecdrs_searchto find calls by transcription keywords, then enrich results withcdrs_get.
- Pull and transcribe recordings— Get a recording viacall_recording_get, request transcription withcdrs_retranscribe, and fetch results viacdrs_transcription_get.
- Audit billing and invoices— Review spending withbilling_transactions_listand download invoice PDFs viabilling_invoices_download.

AModel Context Protocolserver that gives LLMs and AI agents direct access to theWavix telecom platform— SMS/MMS, voice calls, 2FA, SIP trunking, phone-number management, 10DLC registration, call recordings, speech analytics, and billing.

Wavixis a global communications platform for sending SMS, placing voice calls, and running 2FA flows over a single API. Afree trialis available; paid usage follows the Wavixpricingplan attached to your account.

The fastest way to use this MCP server is thehosted endpointathttps://mcp.wavix.com/mcp— point any MCP-compatible client at it and authenticate with your Wavix API key. If you need to self-host (custom Wavix deployment, behind a firewall, dedicated instance), seeRun your own.

- Endpoint
-
Install—one-click,Claude Code,Claude Desktop / Web,Cursor,VS Code,Codex CLI,Windsurf
-
Run your own(self-host)
-
Examples
-
Tools→full catalogue in TOOLS.md
-
Resources
-
Authentication(best practices,if a token is compromised)
-
Troubleshooting
-
Compatibility & limits
-
Support,Contributing,Security,License

Get a Wavix API key from theWavix Console→Administration → API keys → Create new.

Before you start:grab your Wavix API key.

⚠️The buttons below seed your editor's MCP config with a placeholder tokenYOUR_API_KEY.After the editor finishes installing, open the generated config and replace the placeholder with your real API key before sending any request — otherwise every call will return401 Unauthorized.

To remove later:open the same config file (~/.cursor/mcp.json,.vscode/mcp.json, or the equivalent for your editor) and delete thewavixentry, or remove the connector through your editor's MCP / Connectors UI.

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY"

Useclaude mcp listto verify and/mcpinside a session for status.

Settings →ConnectorsAdd custom connector:

- Name:Wavix
- URL:https://mcp.wavix.com/mcp
- Transport:Streamable HTTP
- Authentication header:Authorization: Bearer <api_key>

Add to~/.cursor/mcp.json(or project-level.cursor/mcp.json):

{ "mcpServers": { "wavix": { "url": "https://mcp.wavix.com/mcp", "headers": { "Authorization": "Bearer <api_key>" } } } }

Cursor 2.4+ exposes the full catalogue; earlier versions cap at 40.

Create.vscode/mcp.jsonin your workspace (or add the sameserversobject under the"mcp"key in usersettings.json):

{ "servers": { "wavix": { "type": "http", "url": "https://mcp.wavix.com/mcp", "headers": { "Authorization": "Bearer <api_key>" } } } }

See theVS Code MCP servers guidefor the up-to-date schema.

Codex CLI supports MCP over stdio. Bridge to the hosted server viamcp-remote. Edit~/.codex/config.toml:

[mcp_servers.wavix] command = "npx" args = [ "-y", "mcp-remote", "https://mcp.wavix.com/mcp", "--header", "Authorization:Bearer ${WAVIX_API_KEY}" ] [mcp_servers.wavix.env] WAVIX_API_KEY = "YOUR_API_KEY"

Any MCP client that supportsStreamable HTTPtransport with custom headers will work. Use:

- URL:https://mcp.wavix.com/mcp
- Header:Authorization: Bearer <api_key>

Setting up via an AI agent?Point your agent atllms-install.md— it's a machine-readable install guide that gives the model the URL, header, and per-client configuration in a deterministic format so it doesn't improvise endpoint values.

The hosted server works out of the box for most users. Self-host if you need to point at a non-public Wavix deployment, run behind a firewall, or operate inside your own infrastructure.

docker build -t wavix-mcp-server . docker run --rm -p 8000:8000 wavix-mcp-server

The server listens on port 8000 and exposes the MCP endpoint at/mcp. Point your client athttp://<host>:8000/mcp.

git clone https://github.com/Wavix/wavix-mcp-server.git cd wavix-mcp-server pip install -e . wavix-mcp

No Wavix credentials are required torunthe server — they are forwarded per-request from the MCP client'sAuthorization: Bearer <api_key>header. Self-hosters are responsible for terminating TLS in front of the server (nginx, Caddy, cloud load balancer) before exposing it publicly.

Concrete prompts you can drop into any connected client.

Prompt:"Send an SMS from +13105550100 to +447700900123 saying 'Your verification code is 4821'."

The agent callssms_and_mms_messages_sendwithfrom,to, andtext. Returns the message ID and delivery status.

Prompt:"Send a 2FA verification code to +13105550100 via SMS. When I give you the code I receive, check whether it's correct."

The agent callstwo_fa_verification_create, waits for you to share the code that arrives via SMS, then callstwo_fa_verification_check. Useful for prototyping passwordless flows without writing integration code.

Prompt:"Find an available US toll-free number with SMS capability, add it to my cart, and check out."

The agent chainsbuy_numbers_list(filtering by country and feature),cart_add, andcart_checkout. Confirm with the user before checkout — it charges the account.

Prompt:"Show me all inbound calls from yesterday longer than two minutes where the caller mentioned 'refund'."

The agent usescdrs_searchagainst transcriptions, then enriches each result viacdrs_getfor full call metadata.

Prompt:"Get the recording for call abc-123, ask Wavix to transcribe it, and return the transcription."

The agent callscall_recording_get(returns a pre-signed download URL),cdrs_retranscribe, then pollscdrs_transcription_get.

Prompt:"How much did we spend on SMS last month? Give me a download link for the most recent invoice PDF."

The agent callsbilling_transactions_listfiltered by type and date, thenbilling_invoices_list+billing_invoices_download. The download tool returns apre-signed URLto the PDF, not the file itself — open the URL in a browser or pass it to your client to fetch the actual document.

122 tools, generated from theWavix OpenAPI spec. Arguments mirror request parameters and body fields.

SeeTOOLS.mdfor the complete tool list with one-line descriptions. The authoritative source is theWavix OpenAPI spec— your client always sees the current live catalogue.

In addition to tools, the server exposes Wavix documentation as MCPResources, so the model can pull authoritative context on demand instead of guessing from prior knowledge.

Both sources —docs.wavix.comand theWavix OpenAPI spec— are publicly available and can be browsed directly without authentication.

Resources are fetched lazily onresources/readand cached server-side with a 1-hour TTL. The upstream Bearer token isneverforwarded to documentation hosts — only toapi.wavix.com.

Every request from the client must include:

The server forwards this header toapi.wavix.comper-request. The token:

- isneverlogged,
- isneverforwarded on cross-host redirects (e.g. pre-signed S3 download URLs),
- isneversent to documentation hosts.

If your client follows a pre-signed download URL returned bycall_recording_get,billing_invoices_download,speech_analytics_file_get, orten_dlc_brand_evidence_get, fetch it directly without theAuthorizationheader.

-

Use a dedicated API key for MCP.Create a separate API key athttps://wavix.com→Administration → API keys(or via theapi_keys_createtool itself, from another session). This lets you revoke MCP access without disrupting other integrations.

Rotate periodically.Treat the API key like any production secret: rotate on schedule and on any suspicion of leakage.

Keep API keys out of git.MCP client configs are easy to commit by accident, taking the token with them into history and CI logs. Most clients support${env:VAR}substitution in the header value — store the API key in an env var or your OS keychain and reference it from the config. As a safety net, add the common client-config paths to your project's.gitignore:

.cursor/mcp.json .vscode/mcp.json claude_desktop_config.json .claude/mcp.json .codex/config.toml

- In the Wavix Console, deactivate the key immediately (or callapi_keys_deactivate).
- Create a replacement viaapi_keys_createor the Console.
- Update the client's config and reconnect.
- Reviewbilling_transactions_listandcdrs_listfor unexpected activity.

- Compatible with any MCP client supportingStreamable HTTPtransport (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, custom MCP SDKs) and any agent framework with an MCP client adapter.
- Older clients may enforce a per-server tool cap; upgrade to a recent version to access the full catalogue.
- Rate limits and usage charges follow your Wavix account plan. See
Wavix pricing.

The hosted server is updated continuously as the Wavix OpenAPI spec evolves; new tools appear automatically and existing tool arguments may gain optional fields. Documentation changes for this repository are tracked underReleases. For substantial behavior changes affecting tool inputs or auth, we will publish a notice both there and in theWavix release notes.

- Product docs:https://docs.wavix.com
- API reference:
https://docs.wavix.com/api-reference
- Questions / feedback:
support@wavix.com

This repository issource-availablebutnot open to external contributions. Pull requests are auto-closed, and Issues / Discussions are disabled. Send bug reports, feature requests, and feedback tosupport@wavix.com. SeeCONTRIBUTING.mdfor details.

If you find a bug in the underlyingFastMCPframework, please report it upstream there.

To report a security vulnerability, please emailsupport@wavix.comwith the subjectSecurity: <short summary>rather than opening a public issue. SeeSECURITY.mdfor details.

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Platfone - Receive SMS & Virtual Numbers MCP

Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle

Self-hosted email and SMS platform for AI agents — each agent gets a real email address, phone number, inbox, and API key.

Send SMS messages using the Aligo SMS API.

A read-only MCP server for querying live Twilio data, powered by the CData JDBC Driver.

Send SMS, query delivery reports, manage senders / blacklists, register and check İYS (Turkish messaging consent registry) records through the iletiMerkezi BTK-licensed SMS API. 11 tools, runtime-fetched manifest stays in lock-step with the live API. Install: npx -y @iletimerkezi/mcp-server

A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.

Get virtual phone numbers for SMS verification, OTP receipt, and number management.

Make voice calls and send SMS messages using the Vonage API.

Make voice calls and send SMS messages using the Vonage API.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.