AndroidAPI net MCP
AndroidAPI.net MCP Connector
A Model Context Protocol (MCP) connector for AndroidAPI.net — lets Claude send SMS, WhatsApp messages, OTPs, manage contacts, run USSD codes and more, all via your linked Android device or gateway credits.
Features
52 tools covering every AndroidAPI.net API endpoint
All tools prefixed with
androidapi_— no naming conflicts with other MCP serversFull tool annotations (
readOnlyHint,destructiveHint, etc.)Works with Claude Desktop, Claude Code, and any MCP-compatible host
TypeScript source, zero runtime deps beyond the official MCP SDK
Tool Categories
Category | Tools |
Account |
|
Partners |
|
Contacts |
|
OTP |
|
SMS |
|
Gateways |
|
| |
Android |
|
Miscellaneous |
|
Related MCP server: WAHA WhatsApp MCP Server
Prerequisites
An AndroidAPI.net account
An API key from Tools → API Keys in the dashboard
Node.js 18 or higher
Installation
Option A — npx (recommended, no install needed)
{
"mcpServers": {
"androidapi": {
"command": "npx",
"args": ["-y", "androidapi-mcp"],
"env": {
"ANDROIDAPI_SECRET": "YOUR_API_SECRET"
}
}
}
}Option B — global install
npm install -g androidapi-mcp{
"mcpServers": {
"androidapi": {
"command": "androidapi-mcp",
"env": {
"ANDROIDAPI_SECRET": "YOUR_API_SECRET"
}
}
}
}Claude Desktop Setup
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"androidapi": {
"command": "npx",
"args": ["-y", "androidapi-mcp"],
"env": {
"ANDROIDAPI_SECRET": "YOUR_API_SECRET_HERE"
}
}
}
}Restart Claude Desktop. The androidapi_* tools will appear in Claude's tool list.
Claude Code Setup
claude mcp add androidapi -- npx -y androidapi-mcpThen set your secret in ~/.claude/settings.json or shell profile:
{
"mcpServers": {
"androidapi": {
"command": "npx",
"args": ["-y", "androidapi-mcp"],
"env": {
"ANDROIDAPI_SECRET": "YOUR_API_SECRET_HERE"
}
}
}
}Example Prompts
Once connected, ask Claude:
"Send an SMS to +923012345678 saying 'Your order is ready' using my device"
"Send an OTP to +923001234567 via WhatsApp and verify it when they type it back"
"Create a contact group called 'VIP Customers' and add these numbers to it"
"Send a bulk WhatsApp campaign to my Marketing group with this promotional message"
"Check my remaining AndroidAPI credits"
"Dial *123# on SIM 1 of my Android device and show me the result"
"Link a new WhatsApp account — show me the QR code to scan"
"List all my sent SMS messages from today"
Configuration Reference
Environment Variable | Required | Description |
| ✅ | Your API key from AndroidAPI.net → Tools → API Keys |
Development
git clone https://github.com/tecniforge/androidapi-mcp
cd androidapi-mcp
npm install
npm run build
ANDROIDAPI_SECRET=your_key npm startProject Structure
src/
├── index.ts # MCP server entry point & error handling
├── tools.ts # Tool definitions with schemas and annotations
├── handlers.ts # Routes tool calls to API endpoints
├── client.ts # Typed HTTP client (GET / multipart / URL-encoded)
└── types.ts # TypeScript interfaces for API responsesTest with MCP Inspector
ANDROIDAPI_SECRET=your_key npx @modelcontextprotocol/inspector node dist/index.jsLicense
MIT — see LICENSE
Claude Cowork Plugin
Prefer a no-code experience? Install the AndroidAPI.net Cowork Plugin — a ready-made set of skills for Claude Cowork that wraps this connector with natural language commands.
/send-sms·/send-whatsapp·/send-otp·/manage-contacts·/sms-campaigns·/whatsapp-campaigns
Download Cowork Plugin →
Plugin Repository →
Links
AndroidAPI.net — Official website & dashboard
AndroidAPI.net API Docs — Full API reference
Full Documentation — Setup guides, tools reference & troubleshooting
MCP Documentation — Model Context Protocol spec
TecniForge — Built by TecniForge
Available Tools
52 toolsandroidapi_create_contactA
Create a new contact and assign it to one or more groups.
Inputs: name (required), phone (required), groups (required).
androidapi_create_groupB
Create a new contact group.
Inputs: name (required).
androidapi_delete_contactADestructiveIdempotent
Permanently delete a contact by its ID.
Inputs: id (required).
androidapi_delete_groupADestructiveIdempotent
Delete a contact group by its ID.
Inputs: id (required).
androidapi_delete_notificationADestructiveIdempotent
Delete an Android notification record by ID.
Inputs: id (required).
androidapi_delete_sms_campaignBDestructiveIdempotent
Delete an SMS campaign.
Inputs: id (required).
androidapi_delete_sms_receivedBDestructiveIdempotent
Delete a received SMS message record.
Inputs: id (required).
androidapi_delete_sms_sentBDestructiveIdempotent
Delete a sent SMS message record.
Inputs: id (required).
androidapi_delete_unsubscribedADestructiveIdempotent
Remove an unsubscribed contact record by ID.
Inputs: id (required).
androidapi_delete_ussdCDestructiveIdempotent
Delete a USSD request record by ID.
Inputs: id (required).
androidapi_delete_wa_accountBDestructive
Remove a linked WhatsApp account from the system.
Inputs: unique (required).
androidapi_delete_wa_campaignCDestructiveIdempotent
Delete a WhatsApp campaign.
Inputs: id (required).
androidapi_delete_wa_receivedCDestructiveIdempotent
Delete a received WhatsApp chat record.
Inputs: id (required).
androidapi_delete_wa_sentCDestructiveIdempotent
Delete a sent WhatsApp chat record.
Inputs: id (required).
androidapi_get_contactsARead-only
List saved contacts (paginated). Returns id, name, phone, and group info.
Inputs: page, limit.
androidapi_get_creditsARead-only
Get remaining credit balance (and currency) in your AndroidAPI.net account.
Inputs: no named parameters.
androidapi_get_devicesBRead-only
List linked Android devices (paginated).
Inputs: page, limit.
androidapi_get_earningsARead-only
Get your partner earnings from AndroidAPI.net.
Inputs: no named parameters.
androidapi_get_groupsCRead-only
List contact groups (paginated).
Inputs: page, limit.
androidapi_get_ratesARead-only
Get available SMS gateways and partner device rates. Use the returned IDs as 'gateway' when sending SMS in 'credits' mode.
Inputs: no named parameters.
androidapi_get_shortenersARead-only
List available URL shorteners you can use in SMS and WhatsApp campaigns. Use the returned ID as the 'shortener' parameter when sending messages.
Inputs: no named parameters.
androidapi_get_sms_campaignsBRead-only
List SMS campaigns (paginated).
Inputs: page, limit.
androidapi_get_sms_messageBRead-only
Retrieve a single SMS message by its ID.
Inputs: id (required), type (required).
androidapi_get_sms_pendingBRead-only
List SMS messages currently pending in the send queue (paginated).
Inputs: page, limit.
androidapi_get_sms_receivedARead-only
List received SMS messages (paginated).
Inputs: page, limit.
androidapi_get_sms_sentARead-only
List sent SMS messages (paginated).
Inputs: page, limit.
androidapi_get_subscriptionARead-only
Get your current AndroidAPI.net subscription package name and usage stats.
Inputs: no named parameters.
androidapi_get_unsubscribedCRead-only
List contacts that have unsubscribed (paginated).
Inputs: page, limit.
androidapi_get_ussdCRead-only
List USSD request history (paginated).
Inputs: page, limit.
androidapi_get_wa_accountsARead-only
List linked WhatsApp accounts (paginated).
Inputs: page, limit.
androidapi_get_wa_campaignsCRead-only
List WhatsApp campaigns (paginated).
Inputs: page, limit.
androidapi_get_wa_group_contactsARead-only
List all members of a specific WhatsApp group.
Inputs: gid (required), unique (required).
androidapi_get_wa_groupsARead-only
List WhatsApp groups that belong to a linked account.
Inputs: unique (required).
androidapi_get_wa_messageBRead-only
Retrieve a single WhatsApp message by its ID.
Inputs: id (required), type (required).
androidapi_get_wa_pendingARead-only
List WhatsApp messages currently pending in the queue (paginated).
Inputs: page, limit.
androidapi_get_wa_receivedARead-only
List received WhatsApp chats (paginated).
Inputs: page, limit.
androidapi_get_wa_sentARead-only
List sent WhatsApp chats (paginated).
Inputs: page, limit.
androidapi_get_wa_serversARead-only
List available WhatsApp servers for linking accounts.
Inputs: no named parameters.
androidapi_link_whatsapp_accountA
Generate a QR code to link a brand-new WhatsApp account. Returns a QR image URL and a status link to poll until scanning is complete.
Inputs: sid.
androidapi_relink_whatsapp_accountA
Re-generate the QR code to reconnect an existing (disconnected) WhatsApp account.
Inputs: unique (required), sid.
androidapi_send_otpB
Send a one-time password (OTP) to a phone number via SMS or WhatsApp. Use {{otp}} in the message body to embed the generated code automatically.
Inputs: type (required), phone (required), message (required), sim, +6 more.
androidapi_send_smsA
Send a single SMS to one recipient. Spintax supported in the message body.
Inputs: mode (required), phone (required), message (required), sim, +4 more.
androidapi_send_sms_bulkB
Send an SMS campaign to multiple phone numbers and/or contact groups. Spintax and shortcodes are supported.
Inputs: mode (required), message (required), campaign (required), sim, +6 more.
androidapi_send_ussdA
Send a USSD / MMI request from a linked Android device (e.g. check balance with *123#). Use androidapi_get_devices to get valid device IDs.
Inputs: sim (required), code (required), device (required).
androidapi_send_whatsappB
Send a single WhatsApp message to one recipient. Supports text, media (image/audio/video), and document attachments via URL.
Inputs: account (required), message (required), recipient (required), type, +7 more.
androidapi_send_whatsapp_bulkC
Send a WhatsApp campaign to multiple recipients or contact groups. Supports text, media, and document messages. Spintax and shortcodes supported.
Inputs: account (required), message (required), campaign (required), type, +8 more.
androidapi_start_sms_campaignA
Resume or start a paused SMS campaign.
Inputs: campaign (required).
androidapi_start_wa_campaignA
Resume a paused WhatsApp campaign.
Inputs: campaign (required).
androidapi_stop_sms_campaignB
Pause a running SMS campaign.
Inputs: campaign (required).
androidapi_stop_wa_campaignA
Pause a running WhatsApp campaign.
Inputs: campaign (required).
androidapi_validate_whatsapp_phoneBRead-only
Check whether a phone number is registered on WhatsApp.
Inputs: phone (required), unique (required).
androidapi_verify_otpARead-only
Verify an OTP that was entered by the user. Returns success if the OTP is valid and not expired.
Inputs: otp (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 52 tools
Each tool targets a distinct resource and action (e.g., create_contact, send_sms, delete_wa_campaign). The prefixes clearly separate SMS, WhatsApp, USSD, contacts, groups, and account management, leaving no ambiguity between tools.
All tools follow the pattern `androidapi_<verb>_<resource>`, with consistent snake_case and no deviations. Naming is uniform and predictable across the entire set.
52 tools is significantly higher than the recommended range. While the domain covers multiple channels (SMS, WhatsApp, USSD, OTP, contacts, groups, campaigns, account info), the large number may be overwhelming and could likely be consolidated (e.g., merging send operations or reducing duplicate CRUD patterns).
Core operations for sending messages and managing contacts/groups are covered, including campaigns and OTPs. However, missing update operations for contacts and groups, no tool for editing campaigns (beyond start/stop), and no device or subscription management create notable gaps in the lifecycle coverage.
Maintenance
Related MCP Connectors
Send and read WhatsApp, email and SMS from Claude, ChatGPT, Cursor or any MCP client, from your own accounts: your WhatsApp number (linked by QR code), your mailbox (IMAP/SMTP) and your Android phone (SMS from its SIM). Tools: list-accounts, get-account, add-account, add-email-account, list-messages, send-message (one channel or several in one call). Hosted, OAuth 2.1, nothing to install. Free plan with unlimited messages; paid plans from 19 EUR/month remove the footer and add media and webhooks. Docs and client configs: github.com/UnlimitedMessaging/unlimited-messaging-mcp
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Free WhatsApp MCP server for ChatGPT and Claude: read and search chats, every send you approve.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables remote control of Android phones via Claude Desktop, offering 45+ tools including UI automation for app interactions.5717-
- AlicenseAqualityDmaintenanceEnables Claude to interact with WhatsApp through a unified backend API, providing 20 tools for messaging, media, groups, contacts, and chat management.2235 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnterprise-grade WhatSMS integration for Claude AI providing 173 tools for SMS, WhatsApp, OTP, contacts, and device management.6 npmMIT

textbee-mcpofficial
AlicenseAqualityBmaintenanceSend and read SMS through your own Android phone via textbee.dev, the open-source SMS gateway. Three tools for Claude, Cursor, and any MCP client: send_sms, get_messages (replies, verification codes, delivery status), list_devices. Self-hosted friendly.3444 npm3MIT