TopSMS MCP Server

by topsms-ghbio.github.topsms-ghb/topsms-mcpv1.1.0

Czech SMS gateway: send and schedule SMS, OTP verification codes, delivery status and credit.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active9d ago

Install TopSMS MCP server

claude mcp add topsms -e TOPSMS_CLIENT_ID='<topsms-client-id>' -e TOPSMS_SECRET='<topsms-secret>' -- npx -y topsms-mcp

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<topsms-client-id>",
        "TOPSMS_SECRET": "<topsms-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<topsms-client-id>",
        "TOPSMS_SECRET": "<topsms-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "topsms": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<topsms-client-id>",
        "TOPSMS_SECRET": "<topsms-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<topsms-client-id>",
        "TOPSMS_SECRET": "<topsms-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TOPSMS_CLIENT_ID	yes	—	API key Client ID from the TopSMS dashboard (API klíče)
TOPSMS_SECRET	yes	yes	API key secret from the TopSMS dashboard

Freshness

Active — last maintenance signal 9d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-30 · 9d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 9d ago · official registry · v1.1.0

FAQ

›How do I install the TopSMS MCP server in Claude Code?

Run: claude mcp add topsms -e TOPSMS_CLIENT_ID='<topsms-client-id>' -e TOPSMS_SECRET='<topsms-secret>' -- npx -y topsms-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does TopSMS require an API key?

Yes. It expects TOPSMS_CLIENT_ID, TOPSMS_SECRET, of which 1 is a secret.

›Can I use TopSMS as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is TopSMS in the official MCP registry?

Yes, as io.github.topsms-ghb/topsms-mcp.