1001SMS MCP Server

com.1001sms/mcp-server

Overview

Hosted Streamable HTTP MCP server for 1001SMS that lets AI assistants order virtual SMS activation numbers, check received codes, manage active orders, and inspect account balance, profile, transactions, pricing, countries, and services.

Website

Documentation

Overview

The 1001SMS MCP Server is a hosted remote MCP server for SMS activation workflows. MCP-compatible clients connect to https://www.1001sms.com/api/mcp over Streamable HTTP and authenticate with a 1001SMS API key in the Authorization header.

Remote Connection

No local install is required. Add the remote endpoint to an MCP client configuration:

{
  "mcpServers": {
    "1001sms": {
      "type": "streamableHttp",
      "url": "https://www.1001sms.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with an API key created from the 1001SMS account menu/API settings. The docs state the API key should have the activate permission for activation endpoints; read permission covers lookup and account endpoints.

Capabilities

The MCP page documents these tools: get_balance, get_profile, get_stats, get_transactions, list_services, list_countries, get_pricing, order_number, check_sms, get_order, cancel_order, cancel_all_orders, list_active_orders, and order_history. The linked REST API docs and OpenAPI JSON describe the underlying account, lookup, pricing, activation order, SMS check, cancel, history, and archive endpoints.

Operational Notes

The MCP server is free to use, but order tools spend the user's existing 1001SMS balance. The docs state the assistant should tell the user what it plans to do before calling tools like order_number. Cancellation refunds are conditional: full refunds are only for orders without real SMS messages, and some providers reject very early cancellation attempts for about 1-2 minutes. API errors include missing/invalid/expired API key, insufficient balance, permission/ownership failures, rate limiting, and provider temporary unavailability.