SMS8 - SMS GATEWAY using your phone

by 1fancy

282 downloads

Not rated

GitHub Website

About

Plug unlimited SMS, OTP verification, and inbound webhooks into your AI coding assistant using your paired Android phone as the gateway. Same SMS8 API key, JSON-RPC tools for every flow. No Twilio, no A2P 10DLC, no per-message fees.

Details

Author: 1fancy
Downloads: 282
Categories: Marketing, Other, Communication, API, Community
Tags: #sms

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name SMS8 - SMS GATEWAY using your phone

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

From the repository

Get an SMS8 account, pair an Android phone, and copy your API key. Add the MCP server to your AI tool (Claude Code, Cursor, Windsurf, etc.) via the hosted HTTP endpoint at https://mcp.sms8.io with a Bearer token, or run npx -y sms8-mcp with the SMS8_API_KEY environment variable. Then ask your AI to send SMS or verify OTPs.

`create_webhook`

Register a webhook URL that SMS8 will POST inbound messages and delivery events to. Returns the configured webhook + a sample payload schema the AI can use to scaffold the receiving handler. Pass `enabled: false` to remove the webhook.

`get_balance`

Return the user's remaining SMS credits, plan name, expiry date and a one-line human summary. Lightweight, safe to call any time before a bulk send to check whether the account has enough credits left for the job.

`get_messages`

Fetch recent SMS messages on the user's account. Filter by direction (received|sent|all) and limit. Useful for showing inbox state, debugging delivery, or building reply flows.

`list_devices`

List the user's paired SMS8 devices (phones running the SMS8 Android app). Returns each device's ID, model, primary flag, and enabled status. If the list is empty, the user needs to install + pair the Android app at app.sms8.io/devices.php.

`send_otp`

Send a one-time verification code to a phone number. Stores the code server-side; verify later with verify_otp. 5-minute expiry, 5 attempts, 60-second resend cooldown by default. Hard per-phone cap of 5 OTPs per 24h.

`verify_otp`

Verify a code the user typed against the most recent OTP issued for that phone. Returns { verified: true|false, reason }.

`send_sms`

Send an SMS to one phone number through the user's paired SMS8 device(s). Returns the message ID. Supports per-device + per-SIM routing identical to the SMS8 dashboard.

`setup_sms8`

Start here. Validate the user's SMS8 API key and return everything needed to integrate SMS, OTP, and webhooks into their app — including code samples and dashboard links. Pass api_key once via this tool to set up the session.

`wait_for_otp`

Block until a one-time-password SMS arrives on the user's paired Android, or the timeout elapses. Returns the extracted numeric code plus the raw SMS body and sender. Use this when an agent has just submitted a form that triggers an OTP and needs to read it back to complete a signup or 2FA flow. Polls the user's real inbox; no disposable numbers, no third-party VoIP rental.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "sms8 - sms gateway using your phone": {
            "sms8": {
                "url": "https://mcp.sms8.io",
                "transport": "http",
                "headers": {
                    "Authorization": "Bearer YOUR_SMS8_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "sms8": {
        "url": "https://mcp.sms8.io",
        "transport": "http",
        "headers": {
            "Authorization": "Bearer YOUR_SMS8_API_KEY"
        }
    }
}

What can you do with SMS8 SMS GATEWAY Using Your Phone MCP?

- Send an SMS— Ask your AI to send a text message to any number usingsend_sms, routed through your paired Android phone.
- Issue and verify OTPs— Generate a one-time code withsend_otpand validate it withverify_otpfor signup or login flows.
- Wait for incoming codes— Usewait_for_otpto block until an OTP arrives on the paired device and automatically extract the code.
- Check recent messages— Retrieve inbox or sent SMS history viaget_messages.
- List paired devices— See which Android phones are connected to your account withlist_devices.
- Register a webhook— Configure a callback URL viacreate_webhookto receive inbound SMS and delivery events.

SMS gateway→ sms8.io·SMS Gateway MCP for vibe coders & developers→ mcp.sms8.io

Send SMS, issue and verify OTPs, wait for incoming codes, and configure webhooks from Claude Code, Cursor, Windsurf, OpenCode and any other AI coding tool that speaks the Model Context Protocol. SMS routes through a paired Android phone via the SMS8 platform.

Live server:https://mcp.sms8.ioDashboard:https://app.sms8.ioMarketing site:https://sms8.io

Building an app and want SMS notifications, OTPs, two-way messaging, or autonomous-agent phone verification? Most options force you to register with carrier programs, provision phone numbers, pay per message, or rent a disposable SIM per session. SMS8 routes SMS through a phone you already own. The MCP server gives your AI assistant nine tools it can call directly, so adding SMS to a project takes one prompt instead of an hour of integration work.

All tools share the same send pipeline as the SMS8 dashboard. Credits, retries, multi-device routing, and webhook signing work identically to a direct API call.

Six packages cover every flow — pick whichever fits your project.

MCP example (Claude Code, Cursor, Windsurf — same config shape):

{ "mcpServers": { "sms8": { "command": "npx", "args": ["-y", "sms8-mcp"], "env": { "SMS8_API_KEY": "sk_xxx" } } } }

export SMS8_API_KEY=sk_xxx npx sms8-cli send +14155550100 "Hello" CODE=$(npx sms8-cli otp wait +Google --timeout=120)

import { OtpForm } from 'react-sms-otp'; <OtpForm apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!} onVerified={(phone) => router.push('/dashboard')} />

Source for all six packages lives innpm-packages/.

For native mobile apps, the sdks/folder ships Kotlin (Android) and Swift (iOS) SDKs with thesend / verifyAPI +SMS auto-fill helpers(Google SMS Retriever on Android,oneTimeCodecontent type on iOS).

Both SDKs are MIT, share the same SMS8 API key, and target the same Twilio-Verify-alternative use cases.

Sign up atapp.sms8.io. Free 5-day trial, no credit card. Pair your Android phone via QR and copy your API key fromProfile then API.

Hosted HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

{ "mcpServers": { "sms8": { "url": "https://mcp.sms8.io", "transport": "http", "headers": { "Authorization": "Bearer YOUR_SMS8_API_KEY" } } } }

/plugin marketplace add 1fancy/sms8-sms-gateway /plugin install sms8-sms-gateway

Thenexport SMS8_API_KEY=sk_xxxin your shell before launching Claude Code.

{ "mcpServers": { "sms8": { "command": "npx", "args": ["-y", "@sms8/mcp"], "env": { "SMS8_API_KEY": "sk_your_key" } } } }

The dashboard atapp.sms8.io/mcp-setup.phpprefills the JSON for each AI tool, shows your device pairing QR if needed, and includes a live SMS test form.

Add SMS verification to my signup flow using the sms8 MCP.

The AI will callsetup_sms8, thensend_otpandverify_otp, and write production code that works on the first try.

These are real one-line prompts you can paste into Claude Code, Cursor, or Windsurf.

Wire phone-number verification into this app using the sms8 MCP. Use send_otp on /signup, verify_otp on /verify-phone. Render the remaining attempts on error.

When an order ships, send the customer an SMS with their tracking link via the sms8 MCP.

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox. Scaffold the handler that verifies the HMAC signature and routes inbound SMS to the support queue.

Replace the magic-link email login with SMS OTPs using the sms8 MCP. 6-digit code, 5-minute expiry, 5 attempts.

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after 5 failed verify_otp attempts.

Each file inexamples/is production-ready, zero-dependency, and copy-paste-able. These are what the AI generates after asetup_sms8handshake.

- php-send.php: minimalSms8Senderclass withsend,sendOtp,verifyOtp
- js-fetch.js: Node / browser / Cloudflare Worker client (ESM and CommonJS)
- otp-flow.php: complete phone-verification flow (startSignup+verifySignup)
- webhook-handler.php: inbound SMS handler with HMAC signature check

An HTTPS endpoint atmcp.sms8.iothat implements the Model Context Protocol. AI coding tools call its JSON-RPC interface to send SMS, issue OTPs, and configure webhooks. SMS routes through a paired Android phone via the SMS8 platform.

SMS8 uses your own Android phone as the gateway with your existing SIM card. There are no per-message carrier fees, no A2P 10DLC registration, and no phone number to provision. You pay a flat plan and send unlimited SMS. The MCP server exposes seven tools your AI assistant can call directly, which Twilio does not offer.

Yes. Add the MCP server to~/.config/claude/mcp-servers.jsonwith the HTTP transport pointing athttps://mcp.sms8.ioand your SMS8 API key as a Bearer token. Or run/plugin marketplace add 1fancy/sms8-sms-gatewayfollowed by/plugin install sms8-sms-gateway.

Does this work with Cursor and Windsurf?

Yes. Both support HTTP MCP servers. Addhttps://mcp.sms8.iowith your API key as a Bearer header to~/.cursor/mcp.json(Cursor) or~/.codeium/windsurf/mcp_config.json(Windsurf). The setup wizard atapp.sms8.io/mcp-setup.phpprefills the JSON per tool.

Can the AI add OTP verification automatically?

Yes. The bundled Claude Code Skill (skills/send-sms/SKILL.md) teaches the assistant when to callsend_otpandverify_otp, and how to wrap an existing signup or login route with the verification step. A prompt like"add phone verification to /signup"is enough.

Yes, MIT-licensed. The server, all seven tool implementations, the npm launcher (@sms8/mcp), the Claude Code plugin manifest, and example code live in this repo.

Your API key authenticates each MCP tool call through anAuthorization: Bearerheader (orX-Api-Key). The hosted server validates it against your SMS8 account, then routes the call through the existing SMS8 send pipeline. Thesetup_sms8response returns only the last four characters of your key, so it never leaks into AI chat history or logs.

Yes. Clone the repo, setSMS8_APP_PATHto your SMS8 install directory, and run:

git clone https://github.com/1fancy/sms8-sms-gateway.git cd sms8-sms-gateway export SMS8_APP_PATH=/path/to/your/sms8-install php -S 127.0.0.1:8080 index.php

The hosted server atmcp.sms8.iois free and easier for most users.

Vibe coding is shipping working software by describing what you want in plain English to an AI assistant instead of writing every line by hand. SMS8 MCP makes one of the most common requests ("add SMS notifications") possible without ever touching a carrier portal or A2P paperwork.

This repository contains no secrets. All credentials live in environment variables or your AI tool's MCP config:

SMS8_API_KEY=sk_… # from app.sms8.io → Profile → API SMS8_WEBHOOK_SECRET=… # from app.sms8.io → Webhook

For full security details see the FAQ section above. A separate security audit summary is available on request.

. ├── README.md this file ├── LICENSE MIT ├── index.php MCP server entry (JSON-RPC dispatcher) ├── landing.html marketing landing at mcp.sms8.io ├── .claude-plugin/plugin.json Claude Code plugin manifest ├── .mcp.json MCP server config referenced by the plugin ├── skills/send-sms/SKILL.md teaches Claude when to invoke SMS8 tools ├── npm-packages/ five published npm packages │ ├── sms8-mcp/ MCP stdio bridge (sms8-mcp) │ ├── sms8-cli/ universal CLI (sms8) │ ├── sms-otp-using-myphone/ OTP-only brand of the CLI │ ├── phone-sms-gateway/ phone-as-gateway brand of the CLI │ └── send-sms-from-android/ Android-first brand of the CLI ├── lib/ Auth, JsonRpc, ToolRegistry ├── tools/ 7 tool implementations └── examples/ PHP and JS drop-in samples

- HTTP MCP server live atmcp.sms8.io
- OTP endpoints with per-phone abuse cap
- npm packagessms8-mcp,sms8-cli,sms-otp-using-myphone,phone-sms-gateway,send-sms-from-android
- Claude Code plugin and Skill
- MMS support
- Inbound SMS auto-routed to AI for reply generation
- Per-tool rate limits configurable in the dashboard
- Code examples in Python, Go, and Ruby

Issues and pull requests welcome at github.com/1fancy/sms8-sms-gateway. Open a discussion before larger changes.

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

Buy a number for a single SMS verification, rent one for months, and get pushed a webhook the moment a code arrives. Everything the website does, over HTTPS.

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

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.

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

MCP server for M-Pesa (Safaricom Daraja) and Africa's Talking APIs. Gives AI coding assistants — Claude Code, Cursor, GitHub Copilot — direct access to East African payment and SMS infrastructure from a single server. What it does: STK Push payments via Safaricom Daraja (triggers M-Pesa prompt on user's phone) Transaction status queries SMS to 20+ African telecom networks via Africa's Talking Airtime top-up across East and West Africa Safety: All 5 tools are annotated per MCP 2025-03-26 spec — payment and SMS tools declare destructiveHint: true, so Claude Desktop and other clients show confirmation dialogs before executing. Query tools declare readOnlyHint: true for auto-approval. Install: pip install mpesa-mcp Who it's for: Developers building AI agents for East African markets. M-Pesa handles ~$50B/year in transactions and reaches 50M+ users. Africa's Talking reaches 300M+ phones across 20+ telecoms.

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.

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

create_webhook

get_balance

get_messages

list_devices

send_otp

verify_otp

send_sms

setup_sms8

wait_for_otp

Claude Desktop / Cursor

McpServers

What can you do with SMS8 SMS GATEWAY Using Your Phone MCP?

Hosted HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

Does this work with Cursor and Windsurf?

Can the AI add OTP verification automatically?

Platfone - Receive SMS & Virtual Numbers MCP

Install

More like this

Sequential Thinking

Slack

Filesystem

EverArt

Google Drive

Reactive Resume

`create_webhook`

`get_balance`

`get_messages`

`list_devices`

`send_otp`

`verify_otp`

`send_sms`

`setup_sms8`

`wait_for_otp`