textverified-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@textverified-mcp create an SMS verification for Discord and fetch the code when it arrives"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TextVerified 插件
English README · GitHub · TextVerified API v2 文档
textverified-mcp 是一个可安装到 Codex、ChatGPT 以及其他兼容 Agent 的 TextVerified 插件。它封装完整的 TextVerified API v2,并为 SMS 和 voice verification 提供快捷工作流。
一句话安装
把下面这句话直接发给支持插件的 Agent:
请从 https://github.com/guangfuhao/textverified-mcp 安装 TextVerified 插件,安装完成后打开插件设置页面,让我配置 TextVerified 用户名和 API Key。
Codex CLI 也可以从个人或仓库 marketplace 安装:
codex plugin marketplace add https://github.com/guangfuhao/textverified-mcp
codex plugin add textverified-mcp不同 Agent 的插件目录和命令可能不同;上面的一句话安装请求会让 Agent 选择其支持的安装方式。
Related MCP server: Telnyx MCP Server
首次配置
插件安装后会通过 textverified-setup onboarding skill 引导用户配置:
TextVerified username:TextVerified 注册邮箱;
TextVerified API key:TextVerified 主 API Key;
API base URL:默认使用
https://www.textverified.com。
保存后,插件把凭据写入当前用户的本地配置文件,并设置为仅文件所有者可读(权限 0600)。API Key 在设置读取结果中始终显示为掩码,不会写入 GitHub、README、聊天消息或工具参数。无图形设置页的 CI/headless 环境可以使用 TEXTVERIFIED_USERNAME 和 TEXTVERIFIED_API_KEY 环境变量。
如果宿主支持 OpenAI MCP Extensions,设置页由 openai/settings capability 原生渲染。当前 Codex 的本地插件详情页可能只显示技能;此时 onboarding skill 会调用 textverified_setup_local,启动一个只监听本机的临时配置页,保存后自动关闭。无法启动本地页的 CI/headless 环境再使用环境变量或密钥存储。
支持能力
textverified_request:调用所有/api/pub/v2/*API v2 接口;创建和查询 SMS/voice verification;
查询和发送 SMS;
查询语音通话并创建来电访问令牌;
创建租号;
访问服务、价格、库存、计费、backorder、唤醒请求、webhook 定义和分页链接等其他接口。
完整 OpenAPI 合同见 docs/api-v2.openapi.json,接口清单见 docs/endpoints.md。
安全行为
购买、退款、续期、回复、发送 SMS、扩展等操作可能消耗余额或改变账号状态。快捷写操作要求显式确认参数,通用 API 工具也应只在明确了解请求后使用。建议集成测试优先使用官方文档中的 test_* mock 服务名。
客户端会缓存短期 bearer token,对临时网络错误、429 和 5xx 做有上限的退避重试,支持 Idempotency-Key,并限制请求只能访问 TextVerified API v2 域名。
本地开发
python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
pytest -q测试使用本地 mock transport,不会访问 TextVerified,也不会购买号码。
项目文件
plugin.json:可移植 Agent Plugins 清单;mcp.json:插件内置 stdio MCP server 配置;.agents/plugins/marketplace.json:从 GitHub 仓库发现和安装插件的 marketplace 清单;skills/setup/SKILL.md:首次安装配置引导;skills/textverified-usage/SKILL.md:使用与安全规则;docs/api-v2.openapi.json:官方 API v2 OpenAPI 快照;src/textverified_mcp/:Python 客户端和 MCP server。
许可
MIT。本项目是独立的社区客户端,TextVerified 商标归其权利人所有,TextVerified 未对本项目作任何背书。
Available Tools
11 toolstextverified_create_call_access_tokenC
Create the incoming-call access token for a reservation.
Inputs: reservation_id (required). Returns: result
textverified_create_rentalC
Purchase a rental number; requires explicit confirmation.
Inputs: duration (required), service_name (required), options, capability, +5 more. Returns: result
textverified_create_verificationA
Purchase a single-use verification number for SMS or voice.
Set confirm_purchase=true only after confirming service, capability, and max price. Use test_* service names to exercise the documented mock flow.
Inputs: service_name (required), options, max_price, capability, +2 more. Returns: result
textverified_get_verificationC
Read verification status and its follow-up links.
Inputs: verification_id (required). Returns: result
textverified_list_callsC
List voice calls associated with the account or reservation.
Inputs: to, extra_query, reservation_id, reservation_type. Returns: result
textverified_list_smsB
List received SMS, optionally filtered by reservation or number.
Inputs: to, extra_query, reservation_id, reservation_type. Returns: result
textverified_requestB
Call any TextVerified API v2 endpoint.
Use the exact relative path from docs, such as /api/pub/v2/services. This is the complete escape hatch for all current and future v2 endpoints. Purchase, refund, renewal, reply, and other state-changing calls spend account credits or change account state; use only when explicitly intended.
Inputs: path (required), method (required), body, query, +1 more. Returns: result
textverified_send_smsB
Send an SMS from a rented number; requires explicit confirmation.
Inputs: content (required), send_to (required), reservation_id (required), confirm_send. Returns: result
textverified_settings_readTextVerified settingsARead-only
Read the current TextVerified plugin settings. The API key is always masked.
Inputs: no named parameters. Returns: Structured settings payload consumed by the native plugin settings page.
textverified_settings_updateSave TextVerified settingsB
Save TextVerified credentials entered in the plugin settings page.
Inputs: set (required). Returns: values
textverified_setup_localOpen TextVerified local setupA
Launch a one-shot localhost form for entering TextVerified credentials. The form closes its service after saving.
Inputs: open_browser. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clearly distinct purposes, but the generic `textverified_request` escape hatch overlaps functionally with every specific tool, creating some risk of misselection. The settings tools (`read`, `update`, `setup_local`) are also slightly overlapping in purpose, though descriptions help differentiate them.
All tools use a consistent `textverified_` prefix and snake_case, which is predictable. However, the pattern is not uniformly verb_noun: `textverified_settings_read` and `textverified_settings_update` invert to noun_verb, and `textverified_setup_local` deviates slightly.
With 11 tools, the set is well-scoped for a TextVerified API integration. Each tool appears to earn its place, covering key actions without excessive granularity or redundancy.
The surface covers core verification, rental, SMS, calls, and settings operations. Minor gaps exist for rental lifecycle management (e.g., list/release) and verification cancellation, but the generic `textverified_request` tool provides a complete escape hatch for any missing endpoint.
Related MCP Connectors
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Give your AI assistant a real phone line. Place and end real phone calls with AI voice agents, read call transcripts, run a live two-way interpreter between two people who share no language (31 languages, browser link or phone), create and edit voice agents, and search, buy and bind phone numbers in 21 countries. OAuth 2.1 with PKCE — the model never sees your API key; a read-only scope is available. Pay as you go from $0.10/min, $5 free credit for new accounts.
Business texting for AI agents: send texts, read threads, manage contacts and run campaigns.
Let AI agents place real phone calls from your verified number, with transcripts and recordings.
Related MCP Servers
FlicenseBqualityFmaintenanceEnables interaction with Telnyx's telephony, messaging, and AI assistant APIs to manage phone numbers, send messages, make calls, and create AI assistants. Includes webhook support for real-time event handling and comprehensive tools for voice, SMS, cloud storage, and embeddings.4625-- AlicenseNot gradedqualityDmaintenanceProvides comprehensive access to Telnyx's telephony and communication services including call control, SMS/MMS messaging, fax, number management, and SIM card operations. Implements 822 API endpoints from Telnyx API v2.0.0 for complete telecommunications functionality.MIT
- AlicenseAqualityDmaintenanceProvides complete programmatic access to the Retell AI platform, enabling autonomous management of voice and text agents, telephony, and monitoring.60MIT

VoidMob MCPofficial
AlicenseAqualityBmaintenancePhone numbers, mobile IPs and eSIMs for your AI agent.28181 npm22MIT