[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_115":116},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@wavix/wavix-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","wavix","moduleId","wavix-mcp-server","@wavix/wavix-mcp-server","displayName","Wavix","tagline","Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.","iconKey","https://avatars.githubusercontent.com/u/159887252?v=4","category","communication","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.wavix.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363378000,"updatedAt",1781499559000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.Wavix%2Fmcp","sourceVerified",true,"importedAt","upstreamStars",1,"upstreamUpdatedAt",1779688822000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Wavix/wavix-mcp-server","githubRepoFullName","Wavix/wavix-mcp-server","releaseId","ext-wavix-wavix-mcp-server","version","1.0.0","descriptionMarkdown","# Wavix MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/Model_Context_Protocol-supported-blue.svg)](https://modelcontextprotocol.io)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that gives LLMs and AI agents direct access to the **Wavix telecom platform** — SMS/MMS, voice calls, 2FA, SIP trunking, phone-number management, 10DLC registration, call recordings, speech analytics, and billing.\n\n[Wavix](https://wavix.com) is a global communications platform for sending SMS, placing voice calls, and running 2FA flows over a single API. A [free trial](https://wavix.com) is available; paid usage follows the Wavix [pricing](https://wavix.com/pricing) plan attached to your account.\n\nThe fastest way to use this MCP server is the **hosted endpoint** at `https://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), see [Run your own](#run-your-own).\n\n## Table of contents\n\n- [Endpoint](#endpoint)\n- [Install](#install) — [one-click](#one-click-install), [Claude Code](#claude-code), [Claude Desktop / Web](#claude-desktop--claude-web), [Cursor](#cursor-manual), [VS Code](#vs-code-manual-github-copilot-chat), [Codex CLI](#codex-cli), [Windsurf](#windsurf--other-clients)\n- [Run your own](#run-your-own) (self-host)\n- [Examples](#examples)\n- [Tools](#tools) → [full catalogue in TOOLS.md](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md)\n- [Resources](#resources)\n- [Authentication](#authentication) ([best practices](#best-practices), [if a token is compromised](#if-a-token-is-compromised))\n- [Troubleshooting](#troubleshooting)\n- [Compatibility & limits](#compatibility--limits)\n- [Support](#support), [Contributing](#contributing), [Security](#security), [License](#license)\n\n## Endpoint\n\n| Field | Value |\n| --- | --- |\n| URL | `https://mcp.wavix.com/mcp` |\n| Transport | Streamable HTTP |\n| Auth | `Authorization: Bearer ` |\n| Tools | see [TOOLS.md](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md) |\n| Resources | Wavix docs + OpenAPI spec (auto-discovered) |\n\nGet a Wavix API key from the [Wavix Console](https://wavix.com) → **Administration → API keys → Create new**.\n\n## Install\n\n**Before you start:** grab your Wavix API key.\n\n1. Sign in at .\n2. Open **Administration → API keys**.\n3. Click **Create new** (or copy an existing key). Keep it handy — you'll paste it in place of `YOUR_API_KEY` below.\n\n### One-click install\n\n> ⚠️ **The buttons below seed your editor's MCP config with a placeholder token `YOUR_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 return `401 Unauthorized`.\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-007ACC?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22wavix%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//mcp.wavix.com/mcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20YOUR_API_KEY%22%7D%7D)\n[![Install in Cursor](https://img.shields.io/badge/Cursor-Install-000000?style=flat-square&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=wavix&config=eyJ1cmwiOiJodHRwczovL21jcC53YXZpeC5jb20vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfQVBJX0tFWSJ9fQ==)\n\n**To remove later:** open the same config file (`~/.cursor/mcp.json`, `.vscode/mcp.json`, or the equivalent for your editor) and delete the `wavix` entry, or remove the connector through your editor's MCP / Connectors UI.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http wavix https://mcp.wavix.com/mcp \\\n --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n\nUse `claude mcp list` to verify and `/mcp` inside a session for status.\n\n### Claude Desktop / Claude Web\n\nSettings → **Connectors** → **Add custom connector**:\n\n- Name: `Wavix`\n- URL: `https://mcp.wavix.com/mcp`\n- Transport: `Streamable HTTP`\n- Authentication header: `Authorization: Bearer `\n\n### Cursor (manual)\n\nAdd to `~/.cursor/mcp.json` (or project-level `.cursor/mcp.json`):\n\n```json\n{\n \"mcpServers\": {\n \"wavix\": {\n \"url\": \"https://mcp.wavix.com/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer \"\n }\n }\n }\n}\n```\n\nCursor 2.4+ exposes the full catalogue; earlier versions cap at 40.\n\n### VS Code (manual, GitHub Copilot Chat)\n\nCreate `.vscode/mcp.json` in your workspace (or add the same `servers` object under the `\"mcp\"` key in user `settings.json`):\n\n```json\n{\n \"servers\": {\n \"wavix\": {\n \"type\": \"http\",\n \"url\": \"https://mcp.wavix.com/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer \"\n }\n }\n }\n}\n```\n\nSee the [VS Code MCP servers guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers) for the up-to-date schema.\n\n### Codex CLI\n\nCodex CLI supports MCP over stdio. Bridge to the hosted server via [`mcp-remote`](https://www.npmjs.com/package/mcp-remote). Edit `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.wavix]\ncommand = \"npx\"\nargs = [\n \"-y\",\n \"mcp-remote\",\n \"https://mcp.wavix.com/mcp\",\n \"--header\",\n \"Authorization:Bearer ${WAVIX_API_KEY}\"\n]\n\n[mcp_servers.wavix.env]\nWAVIX_API_KEY = \"YOUR_API_KEY\"\n```\n\n### Windsurf / other clients\n\nAny MCP client that supports **Streamable HTTP** transport with custom headers will work. Use:\n\n- URL: `https://mcp.wavix.com/mcp`\n- Header: `Authorization: Bearer `\n\n**Setting up via an AI agent?** Point your agent at [`llms-install.md`](https://github.com/Wavix/wavix-mcp-server/blob/main/llms-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.\n\n## Run your own\n\nThe 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.\n\n### Docker\n\n```bash\ndocker build -t wavix-mcp-server .\ndocker run --rm -p 8000:8000 wavix-mcp-server\n```\n\nThe server listens on port 8000 and exposes the MCP endpoint at `/mcp`. Point your client at `http://:8000/mcp`.\n\n### From source\n\n```bash\ngit clone https://github.com/Wavix/wavix-mcp-server.git\ncd wavix-mcp-server\npip install -e .\nwavix-mcp\n```\n\nRequires Python 3.10+.\n\n### Configuration\n\n| Env var | Default | Purpose |\n| --- | --- | --- |\n| `WAVIX_API_BASE_URL` | `https://api.wavix.com` | Override the upstream Wavix API endpoint (for internal deployments or staging) |\n\nNo Wavix credentials are required to **run** the server — they are forwarded per-request from the MCP client's `Authorization: Bearer ` header. Self-hosters are responsible for terminating TLS in front of the server (nginx, Caddy, cloud load balancer) before exposing it publicly.\n\n## Examples\n\nConcrete prompts you can drop into any connected client.\n\n> Phone numbers below (`+1 310 555 0100`, `+44 7700 900123`) are in reserved test ranges (NANP `555` and Ofcom `070 09xx`) — safe to copy verbatim, no real subscribers are reachable through them.\n\n### Send a transactional SMS\n\n> *Prompt:* \"Send an SMS from +13105550100 to +447700900123 saying 'Your verification code is 4821'.\"\n\nThe agent calls `sms_and_mms_messages_send` with `from`, `to`, and `text`. Returns the message ID and delivery status.\n\n### Run a 2FA verification\n\n> *Prompt:* \"Send a 2FA verification code to +13105550100 via SMS. When I give you the code I receive, check whether it's correct.\"\n\nThe agent calls `two_fa_verification_create`, waits for you to share the code that arrives via SMS, then calls `two_fa_verification_check`. Useful for prototyping passwordless flows without writing integration code.\n\n### Find and buy a phone number\n\n> *Prompt:* \"Find an available US toll-free number with SMS capability, add it to my cart, and check out.\"\n\nThe agent chains `buy_numbers_list` (filtering by country and feature), `cart_add`, and `cart_checkout`. Confirm with the user before checkout — it charges the account.\n\n### Search call transcripts\n\n> *Prompt:* \"Show me all inbound calls from yesterday longer than two minutes where the caller mentioned 'refund'.\"\n\nThe agent uses `cdrs_search` against transcriptions, then enriches each result via `cdrs_get` for full call metadata.\n\n### Pull a recording and transcribe it\n\n> *Prompt:* \"Get the recording for call abc-123, ask Wavix to transcribe it, and return the transcription.\"\n\nThe agent calls `call_recording_get` (returns a pre-signed download URL), `cdrs_retranscribe`, then polls `cdrs_transcription_get`.\n\n### Audit billing\n\n> *Prompt:* \"How much did we spend on SMS last month? Give me a download link for the most recent invoice PDF.\"\n\nThe agent calls `billing_transactions_list` filtered by type and date, then `billing_invoices_list` + `billing_invoices_download`. The download tool returns a **pre-signed URL** to the PDF, not the file itself — open the URL in a browser or pass it to your client to fetch the actual document.\n\n## Tools\n\n\n122 tools, generated from the [Wavix OpenAPI spec](https://github.com/Wavix/wavix-openapi). Arguments mirror request parameters and body fields.\n\n| Group | # | Coverage |\n| --- | ---: | --- |\n| [SMS and MMS](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#sms-and-mms) | 10 | Send, list, retrieve messages; sender IDs; opt-outs |\n| [Call control](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#call-control) | 9 | Start / answer / end calls; play audio; collect DTMF |\n| [Call recording](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#call-recording) | 3 | List, download (pre-signed URL), delete |\n| [Call streaming](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#call-streaming) | 2 | Start / stop media stream |\n| [Call webhooks](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#call-webhooks) | 3 | List, create, delete |\n| [CDRs](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#cdrs) | 6 | List, export, retrieve; transcription search and retranscribe |\n| [Speech Analytics](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#speech-analytics) | 4 | Upload, transcribe, retrieve original file |\n| [2FA](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#2fa) | 6 | Create / check / cancel / resend verification; events |\n| [My numbers](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#my-numbers) | 7 | List, update, release; SMS / voice routing; document upload |\n| [Buy](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#buy) | 5 | Countries, regions, cities; available number search |\n| [Cart](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#cart) | 4 | Add, remove, retrieve, checkout |\n| [Number validator](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#number-validator) | 3 | Single and bulk validation |\n| [SIP trunks](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#sip-trunks) | 5 | Full CRUD |\n| [10DLC](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#10dlc) | 30 | Brands, campaigns, vetting, evidence, event subscriptions |\n| [Profile](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#profile) | 3 | Get / update profile; account config |\n| [API Keys](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#api-keys) | 5 | List, create, activate / deactivate, delete |\n| [Sub-accounts](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#sub-accounts) | 5 | List, create, get, update; transactions |\n| [Billing](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#billing) | 3 | Transactions, invoices, statement download |\n| [Voice campaigns](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#voice-campaigns) | 2 | Trigger and retrieve |\n| [Wavix Embeddable (WebRTC)](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#wavix-embeddable-webrtc) | 5 | Widget tokens CRUD |\n| [Link shortener](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md#link-shortener) | 2 | Create short links; metrics |\n\n\n\nSee **[TOOLS.md](https://github.com/Wavix/wavix-mcp-server/blob/main/TOOLS.md)** for the complete tool list with one-line descriptions. The authoritative source is the [Wavix OpenAPI spec](https://github.com/Wavix/wavix-openapi) — your client always sees the current live catalogue.\n\n## Resources\n\nIn addition to tools, the server exposes Wavix documentation as MCP **Resources**, so the model can pull authoritative context on demand instead of guessing from prior knowledge.\n\n| URI scheme | Contents |\n| --- | --- |\n| `wavix://docs/` | Documentation pages from [docs.wavix.com](https://docs.wavix.com) (auto-discovered via [`llms.txt`](https://llmstxt.org/)). |\n| `wavix://api/openapi.yaml` | The full Wavix OpenAPI 3.0 specification. |\n\nBoth sources — [docs.wavix.com](https://docs.wavix.com) and the [Wavix OpenAPI spec](https://github.com/Wavix/wavix-openapi) — are publicly available and can be browsed directly without authentication.\n\nResources are fetched lazily on `resources/read` and cached server-side with a 1-hour TTL. The upstream Bearer token is **never** forwarded to documentation hosts — only to `api.wavix.com`.\n\n## Authentication\n\nEvery request from the client must include:\n\n```\nAuthorization: Bearer \n```\n\nThe server forwards this header to `api.wavix.com` per-request. The token:\n\n- is **never** logged,\n- is **never** forwarded on cross-host redirects (e.g. pre-signed S3 download URLs),\n- is **never** sent to documentation hosts.\n\nIf your client follows a pre-signed download URL returned by `call_recording_get`, `billing_invoices_download`, `speech_analytics_file_get`, or `ten_dlc_brand_evidence_get`, fetch it directly without the `Authorization` header.\n\n### Best practices\n\n- **Use a dedicated API key for MCP.** Create a separate API key at → **Administration → API keys** (or via the `api_keys_create` tool itself, from another session). This lets you revoke MCP access without disrupting other integrations.\n- **Rotate periodically.** Treat the API key like any production secret: rotate on schedule and on any suspicion of leakage.\n- **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`:\n\n ```gitignore\n .cursor/mcp.json\n .vscode/mcp.json\n claude_desktop_config.json\n .claude/mcp.json\n .codex/config.toml\n ```\n\n### If a token is compromised\n\n1. In the Wavix Console, deactivate the key immediately (or call `api_keys_deactivate`).\n2. Create a replacement via `api_keys_create` or the Console.\n3. Update the client's config and reconnect.\n4. Review `billing_transactions_list` and `cdrs_list` for unexpected activity.\n\n## Troubleshooting\n\n| Symptom | Likely cause / fix |\n| --- | --- |\n| `401 Unauthorized` from any tool | Missing or invalid `Authorization: Bearer …` header. Verify the API key is active in the Wavix Console. |\n| Tool returns a `download_url`, not the file itself | Expected. Recording, invoice, speech-analytics, and 10DLC evidence endpoints return pre-signed URLs (see [Authentication](#authentication)). Fetch the URL directly without the `Authorization` header. |\n| Client only shows ~40 tools, not the full catalogue | Older clients enforce a per-server tool cap. Upgrade (Cursor 2.4+, latest VS Code, latest Claude). |\n| `Tool not found` for a tool listed in this README | The local client may be caching an old tool list. Restart the client, or remove and re-add the server. |\n| 4xx with an `errors` array | Validation error from Wavix API. Inspect `errors`; cross-reference the relevant `wavix://docs/*` page or the OpenAPI spec. |\n| Cannot reach the server | Confirm DNS and outbound HTTPS to `mcp.wavix.com:443`. |\n| Agent calls a destructive tool unexpectedly | Most clients can require confirmation before tool calls — enable that setting and rotate to a dedicated MCP API key (see [Best practices](#best-practices)). |\n\n## Compatibility & limits\n\n- Compatible with any MCP client supporting **Streamable HTTP** transport (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, custom MCP SDKs) and any agent framework with an MCP client adapter.\n- Older clients may enforce a per-server tool cap; upgrade to a recent version to access the full catalogue.\n- Rate limits and usage charges follow your Wavix account plan. See [Wavix pricing](https://wavix.com/pricing).\n\n## Changelog\n\nThe 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 under [Releases](https://github.com/Wavix/wavix-mcp-server/releases). For substantial behavior changes affecting tool inputs or auth, we will publish a notice both there and in the [Wavix changelog](https://docs.wavix.com/changelog).\n\n## Support\n\n- Product docs: \n- API reference: \n- Questions / feedback: \n\n## Contributing\n\nThis repository is **source-available** but **not open to external contributions**. Pull requests are auto-closed, and Issues / Discussions are disabled. Send bug reports, feature requests, and feedback to . See [`CONTRIBUTING.md`](https://github.com/Wavix/wavix-mcp-server/blob/main/CONTRIBUTING.md) for details.\n\nIf you find a bug in the underlying [FastMCP](https://github.com/jlowin/fastmcp) framework, please report it upstream there.\n\n## Security\n\nTo report a security vulnerability, please email with the subject `Security: ` rather than opening a public issue. See [`SECURITY.md`](https://github.com/Wavix/wavix-mcp-server/blob/main/SECURITY.md) for details.\n\n## License\n\n[MIT](https://github.com/Wavix/wavix-mcp-server/blob/main/LICENSE) © Wavix\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Communication","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106,107,108,109,110,111,112,113,114,19],"license","MIT","language","Python","registryName","io.github.Wavix/mcp","homepage","https://wavix.com","2fa","ai-agents","communications-api","cpaas","llm-tools","mcp","mcp-server","model-context-protocol","sms","voice","ENV",{"_117":118,"_119":120,"_121":122},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]