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

Related MCP server: 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

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

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 →

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

• ahmad@tecniforge.com