@maacgo/mcp

@maacgo/mcp

MCP (Model Context Protocol) server for MAAC Go · lets Claude / Cursor / Windsurf / any MCP-aware client send SMS, pull delivery logs, and check your wallet through your MAAC Go account.

Two ways to run it — pick one.

A. Local stdio (recommended)

{
  "mcpServers": {
    "maacgo": {
      "command": "npx",
      "args": ["-y", "@maacgo/mcp"],
      "env": { "MAACGO_API_KEY": "sk_live_..." }
    }
  }
}

• Drop the above into Claude Desktop's claude_desktop_config.json or Cursor's mcp.json.
• MAACGO_API_KEY accepts sk_live_ or sk_test_; sending follows the account wallet and deployment adapter settings.
• Override base URL with MAACGO_BASE_URL for staging or self-host.

B. Remote HTTP (hosted)

Same tool set, no npm install, authenticate on each request.

{
  "mcpServers": {
    "maacgo": {
      "url": "https://sms.cresclab.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

• Works with clients that speak plain JSON-RPC over HTTP POST.
• Each call is stateless — no session, no SSE. Good enough for tool-calling.

Tools

Tool	Scope	Does
send_sms	sms.send	Send one SMS
list_sms	sms.read	Recent messages (filter by status / since)
get_sms	sms.read	One message by id
sms_metrics	sms.read	N-day delivery + cost stats
send_broadcast	broadcast.send	1:N send, optional schedule
list_broadcasts	broadcast.read	Campaign list with per-campaign stats
wallet_balance	wallet.read	Current NT$ balance
wallet_events	wallet.read	Ledger entries (topups / charges / refunds)
get_me	account.read	Account profile

Scopes are enforced by the backend — a key without broadcast.send scope will get a 403 no matter which transport the call came through.

Get an API key

• Sign in at https://sms.cresclab.com/login.html
• Dashboard → API · 金鑰 → 新增 → copy the sk_... (shown once)
• Paste into your MCP client config

License

MIT