Skip to main content
Glama
AndroidAPI net MCP

AndroidAPI net MCP

by TecniForge

AndroidAPI.net MCP Connector

npm version License: MIT MCP Compatible Node.js

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 servers

  • Full 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

androidapi_get_credits · androidapi_get_subscription

Partners

androidapi_get_earnings

Contacts

androidapi_get_contacts · androidapi_create_contact · androidapi_delete_contact · androidapi_get_groups · androidapi_create_group · androidapi_delete_group · androidapi_get_unsubscribed · androidapi_delete_unsubscribed

OTP

androidapi_send_otp · androidapi_verify_otp

SMS

androidapi_send_sms · androidapi_send_sms_bulk · androidapi_get_sms_sent · androidapi_get_sms_received · androidapi_get_sms_pending · androidapi_get_sms_message · androidapi_get_sms_campaigns · androidapi_start_sms_campaign · androidapi_stop_sms_campaign · androidapi_delete_sms_sent · androidapi_delete_sms_received · androidapi_delete_sms_campaign

Gateways

androidapi_get_rates

WhatsApp

androidapi_send_whatsapp · androidapi_send_whatsapp_bulk · androidapi_get_wa_accounts · androidapi_get_wa_sent · androidapi_get_wa_received · androidapi_get_wa_pending · androidapi_get_wa_message · androidapi_get_wa_campaigns · androidapi_get_wa_groups · androidapi_get_wa_group_contacts · androidapi_validate_whatsapp_phone · androidapi_link_whatsapp_account · androidapi_relink_whatsapp_account · androidapi_get_wa_servers · androidapi_start_wa_campaign · androidapi_stop_wa_campaign · androidapi_delete_wa_sent · androidapi_delete_wa_received · androidapi_delete_wa_campaign · androidapi_delete_wa_account

Android

androidapi_get_devices · androidapi_delete_notification · androidapi_send_ussd · androidapi_get_ussd · androidapi_delete_ussd

Miscellaneous

androidapi_get_shorteners


Related MCP server: WAHA WhatsApp MCP Server

Prerequisites

  1. An AndroidAPI.net account

  2. An API key from Tools → API Keys in the dashboard

  3. Node.js 18 or higher


Installation

{
  "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-mcp

Then 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

ANDROIDAPI_SECRET

✅

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 start

Project 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 responses

Test with MCP Inspector

ANDROIDAPI_SECRET=your_key npx @modelcontextprotocol/inspector node dist/index.js

License

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 →


Available Tools

52 tools
androidapi_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_contactA
DestructiveIdempotent

Permanently delete a contact by its ID.

Inputs: id (required).

androidapi_delete_groupA
DestructiveIdempotent

Delete a contact group by its ID.

Inputs: id (required).

androidapi_delete_notificationA
DestructiveIdempotent

Delete an Android notification record by ID.

Inputs: id (required).

androidapi_delete_sms_campaignB
DestructiveIdempotent

Delete an SMS campaign.

Inputs: id (required).

androidapi_delete_sms_receivedB
DestructiveIdempotent

Delete a received SMS message record.

Inputs: id (required).

androidapi_delete_sms_sentB
DestructiveIdempotent

Delete a sent SMS message record.

Inputs: id (required).

androidapi_delete_unsubscribedA
DestructiveIdempotent

Remove an unsubscribed contact record by ID.

Inputs: id (required).

androidapi_delete_ussdC
DestructiveIdempotent

Delete a USSD request record by ID.

Inputs: id (required).

androidapi_delete_wa_accountB
Destructive

Remove a linked WhatsApp account from the system.

Inputs: unique (required).

androidapi_delete_wa_campaignC
DestructiveIdempotent

Delete a WhatsApp campaign.

Inputs: id (required).

androidapi_delete_wa_receivedC
DestructiveIdempotent

Delete a received WhatsApp chat record.

Inputs: id (required).

androidapi_delete_wa_sentC
DestructiveIdempotent

Delete a sent WhatsApp chat record.

Inputs: id (required).

androidapi_get_contactsA
Read-only

List saved contacts (paginated). Returns id, name, phone, and group info.

Inputs: page, limit.

androidapi_get_creditsA
Read-only

Get remaining credit balance (and currency) in your AndroidAPI.net account.

Inputs: no named parameters.

androidapi_get_devicesB
Read-only

List linked Android devices (paginated).

Inputs: page, limit.

androidapi_get_earningsA
Read-only

Get your partner earnings from AndroidAPI.net.

Inputs: no named parameters.

androidapi_get_groupsC
Read-only

List contact groups (paginated).

Inputs: page, limit.

androidapi_get_ratesA
Read-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_shortenersA
Read-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_campaignsB
Read-only

List SMS campaigns (paginated).

Inputs: page, limit.

androidapi_get_sms_messageB
Read-only

Retrieve a single SMS message by its ID.

Inputs: id (required), type (required).

androidapi_get_sms_pendingB
Read-only

List SMS messages currently pending in the send queue (paginated).

Inputs: page, limit.

androidapi_get_sms_receivedA
Read-only

List received SMS messages (paginated).

Inputs: page, limit.

androidapi_get_sms_sentA
Read-only

List sent SMS messages (paginated).

Inputs: page, limit.

androidapi_get_subscriptionA
Read-only

Get your current AndroidAPI.net subscription package name and usage stats.

Inputs: no named parameters.

androidapi_get_unsubscribedC
Read-only

List contacts that have unsubscribed (paginated).

Inputs: page, limit.

androidapi_get_ussdC
Read-only

List USSD request history (paginated).

Inputs: page, limit.

androidapi_get_wa_accountsA
Read-only

List linked WhatsApp accounts (paginated).

Inputs: page, limit.

androidapi_get_wa_campaignsC
Read-only

List WhatsApp campaigns (paginated).

Inputs: page, limit.

androidapi_get_wa_group_contactsA
Read-only

List all members of a specific WhatsApp group.

Inputs: gid (required), unique (required).

androidapi_get_wa_groupsA
Read-only

List WhatsApp groups that belong to a linked account.

Inputs: unique (required).

androidapi_get_wa_messageB
Read-only

Retrieve a single WhatsApp message by its ID.

Inputs: id (required), type (required).

androidapi_get_wa_pendingA
Read-only

List WhatsApp messages currently pending in the queue (paginated).

Inputs: page, limit.

androidapi_get_wa_receivedA
Read-only

List received WhatsApp chats (paginated).

Inputs: page, limit.

androidapi_get_wa_sentA
Read-only

List sent WhatsApp chats (paginated).

Inputs: page, limit.

androidapi_get_wa_serversA
Read-only

List available WhatsApp servers for linking accounts.

Inputs: no named parameters.

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_phoneB
Read-only

Check whether a phone number is registered on WhatsApp.

Inputs: phone (required), unique (required).

androidapi_verify_otpA
Read-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

    B3.4/5.0

    Scored across 52 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow the pattern `androidapi_<verb>_<resource>`, with consistent snake_case and no deviations. Naming is uniform and predictable across the entire set.

    Tool Count2/5

    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).

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables Claude to interact with WhatsApp through a unified backend API, providing 20 tools for messaging, media, groups, contacts, and chat management.
      22
      35 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Send 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.
      3
      444 npm
      3
      MIT