📦
Mobizon MCP
MCP server for Mobizon Brazil API with SMS send, status, listing, balance, and generic method support.
0 installs
Trust: 34 — Low
Rag
Ask AI about Mobizon MCP
Powered by Claude · Grounded in docs
I know everything about Mobizon MCP. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Mobizon MCP Server
MCP server for integrating with the Mobizon Brazil API (mobizon.com.br).
Exposed Tools
mobizon_get_balance: callsuser/getOwnBalancemobizon_send_sms: callsmessage/sendSmsMessagemobizon_get_sms_status: callsmessage/getSMSStatusmobizon_list_sms: callsmessage/listmobizon_list_users: callsuser/listwith pagination and optional criteria filtersmobizon_list_moderation_campaigns: callscampaign/listglobalfor moderation queuemobizon_approve_moderation_campaigns: callscampaign/approveglobalwithidsmobizon_decline_moderation_campaigns: callscampaign/declineglobalwithidsandcomment(or auto-generated comment)mobizon_call: generic call for any API module/method
In mobizon_send_sms, recipient is normalized to BR mobile format:
55 + DDD + 9 + number (example: 5511999999999).
Requirements
- Node.js 20+
- Mobizon API key
Setup
- Install dependencies:
npm install
- Configure environment variables (based on
.env.example):
MOBIZON_API_KEY(required)MOBIZON_BASE_URL(default:https://api.mobizon.com.br/service)MOBIZON_API_VERSION(default:v1)MOBIZON_TIMEOUT_MS(default:30000)
Run Locally
MOBIZON_API_KEY=your_token npm start
MCP Config Example (Claude Desktop / Codex)
{
"mcpServers": {
"mobizon": {
"command": "node",
"args": ["/path/to/mobizon-mcp/src/index.js"],
"env": {
"MOBIZON_API_KEY": "YOUR_TOKEN_HERE",
"MOBIZON_BASE_URL": "https://api.mobizon.com.br/service",
"MOBIZON_API_VERSION": "v1",
"MOBIZON_TIMEOUT_MS": "30000"
}
}
}
}
Notes
- Authentication is done via
apiKeyin query string, withapi=v1andoutput=json. - The server sends
application/x-www-form-urlencodedfor standardPOSTcalls. - Some moderation endpoints (
approveglobal,declineglobal) use JSON payloads. mobizon_callsupportsGETandPOST.mobizon_list_usersdefaults to:withConfig=1withProfile=1withAccessGroup=1withCPRestriction=1withCountryRestriction=1pagination.currentPage=0pagination.pageSize=25
- For search, use either
criteriadirectly or shortcut fieldsemailandnumber. mobizon_list_usersalso returns (by default)summary.itemsincluding:statuslastLoginTsbalancetotalSpending- Set
includeSummary=falseto receive only the raw API payload.
Architecture
- Entrypoint:
src/index.js - Server bootstrap:
src/server.js - Environment config:
src/config/env.js - Mobizon HTTP client:
src/core/mobizon-client.js - Moderation logic:
src/moderation/auto-comment.js - Utilities:
src/utils/params.js,src/utils/phone.js,src/utils/mcp.js - MCP tools (one file per tool):
src/tools/
Detailed architecture and extension conventions:
docs/ARCHITECTURE.md
Reference
- API docs: https://mobizon.com.br/en/help/api-docs
