setup_sms8LABSCO SUMMARY
Waiting for an inbound code is the tool that makes automated sign-up flows actually work.
Testing anything with phone verification means a human sitting there reading a text message. A blocking wait for the arriving code closes that loop, which is genuinely useful for testing your own flows — and is the same capability someone would want for creating accounts in bulk, so how you use it matters. Using your own handset instead of a carrier API keeps the per-message cost at whatever your plan charges, which for testing volumes is usually nothing.
What it is
An SMS gateway that uses a phone you already own as the sending device, exposed so an agent can send messages, issue and verify one-time codes, and react to inbound ones.
What you get
- Sending SMS
- Issuing and verifying one-time passcodes
- Waiting for an incoming code, rather than polling for it
- Configuring webhooks for inbound messages
Requirements
A paired Android phone acting as the gateway, and npx. There is a hosted server too. MIT licensed.
Setup effort
One command plus a key — npx -y sms8-mcp, then supply credentials
USE CASES
01
Testing a verification flow
Trigger it, then wait for the code to arrive.
02
Sending a message from an agent
Through your own handset.
03
Reacting to an inbound text
Configure a webhook rather than polling.
9 tools
Listed in project docs. Your client may show a different list.
send_smssend_otpverify_otpwait_for_otpget_messageslist_devicesget_balancecreate_webhookBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- npx on PATH
- SMS8_API_KEY in your environment
Where it runs
Of the 6 documented setups, 3 run the server on your machine and 3 connect to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y sms8-mcpHosted endpoint
ENDPOINT URL
https://mcp.sms8.ioSign up at app.sms8.io, pair your Android phone, and copy your SMS8 API key from Profile → API. Use it as <YOUR_SMS8_API_KEY> in the client’s Authorization: Bearer request header.
MCP Clients
Claude Code — stdio, Cursor — stdio, Windsurf — stdio
JSON
{
"mcpServers": {
"sms8": {
"command": "npx",
"args": [
"-y",
"sms8-mcp"
],
"env": {
"SMS8_API_KEY": "<YOUR_SMS8_API_KEY>"
}
}
}
}Claude Code — HTTP, Other MCP clients — HTTP
JSON
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"type": "http",
"headers": {
"Authorization": "Bearer <YOUR_SMS8_API_KEY>"
}
}
}
}Cursor — HTTP
CURSOR — HTTP · JSON
{
"mcpServers": {
"sms8": {
"url": "https://mcp.sms8.io",
"headers": {
"Authorization": "Bearer <YOUR_SMS8_API_KEY>"
}
}
}
}
