@smsmasivos/mcp-server 0.2.2 → 0.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +75 -21
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,28 +1,37 @@
|
|
|
1
1
|
# @smsmasivos/mcp-server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/@smsmasivos/mcp-server)
|
|
4
|
+
[](LICENSE)
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
MCP server para [SMS Masivos](https://www.smsmasivos.com.mx) — plataforma de envio de SMS masivos en Mexico.
|
|
6
7
|
|
|
7
|
-
|
|
8
|
+
Conecta tu asistente de IA con SMS Masivos para enviar mensajes, gestionar contactos, verificar numeros y consultar campanas usando lenguaje natural.
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
## Features
|
|
11
|
+
|
|
12
|
+
- **Envio de SMS** — individuales o masivos, hasta 500 numeros por llamada
|
|
13
|
+
- **Campanas** — lista tus campanas y consulta estadisticas de entrega
|
|
14
|
+
- **Agendas y contactos** — gestiona listas de contactos
|
|
15
|
+
- **Verificacion OTP** — envia y valida codigos por SMS, voz o WhatsApp
|
|
16
|
+
- **Sandbox** — prueba sin enviar mensajes reales ni gastar creditos
|
|
17
|
+
- **Compatible** — funciona con Claude, Cursor, Windsurf y cualquier cliente MCP
|
|
12
18
|
|
|
13
|
-
|
|
19
|
+
## Quick Start
|
|
14
20
|
|
|
15
21
|
```bash
|
|
16
22
|
npx @smsmasivos/mcp-server
|
|
17
23
|
```
|
|
18
24
|
|
|
19
|
-
|
|
25
|
+
Necesitas una API key de SMS Masivos. Obtenla en [tu panel](https://app.smsmasivos.com.mx).
|
|
20
26
|
|
|
21
|
-
|
|
27
|
+
## Configuracion
|
|
22
28
|
|
|
23
29
|
### Claude Desktop
|
|
24
30
|
|
|
25
|
-
Agrega esto a tu
|
|
31
|
+
Agrega esto a tu archivo de configuracion:
|
|
32
|
+
|
|
33
|
+
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
34
|
+
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
26
35
|
|
|
27
36
|
```json
|
|
28
37
|
{
|
|
@@ -31,7 +40,7 @@ Agrega esto a tu configuracion de Claude Desktop (`~/Library/Application Support
|
|
|
31
40
|
"command": "npx",
|
|
32
41
|
"args": ["-y", "@smsmasivos/mcp-server"],
|
|
33
42
|
"env": {
|
|
34
|
-
"SMSMASIVOS_API_KEY": "tu-api-key
|
|
43
|
+
"SMSMASIVOS_API_KEY": "tu-api-key"
|
|
35
44
|
}
|
|
36
45
|
}
|
|
37
46
|
}
|
|
@@ -41,12 +50,55 @@ Agrega esto a tu configuracion de Claude Desktop (`~/Library/Application Support
|
|
|
41
50
|
### Claude Code
|
|
42
51
|
|
|
43
52
|
```bash
|
|
44
|
-
SMSMASIVOS_API_KEY=tu-api-key npx @smsmasivos/mcp-server
|
|
53
|
+
claude mcp add smsmasivos -e SMSMASIVOS_API_KEY=tu-api-key -- npx -y @smsmasivos/mcp-server
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
### Cursor
|
|
57
|
+
|
|
58
|
+
Agrega a `.cursor/mcp.json` en tu proyecto:
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"mcpServers": {
|
|
63
|
+
"smsmasivos": {
|
|
64
|
+
"command": "npx",
|
|
65
|
+
"args": ["-y", "@smsmasivos/mcp-server"],
|
|
66
|
+
"env": {
|
|
67
|
+
"SMSMASIVOS_API_KEY": "tu-api-key"
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
45
72
|
```
|
|
46
73
|
|
|
47
|
-
###
|
|
74
|
+
### Windsurf
|
|
48
75
|
|
|
49
|
-
Agrega
|
|
76
|
+
Agrega a `~/.codeium/windsurf/mcp_config.json`:
|
|
77
|
+
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"mcpServers": {
|
|
81
|
+
"smsmasivos": {
|
|
82
|
+
"command": "npx",
|
|
83
|
+
"args": ["-y", "@smsmasivos/mcp-server"],
|
|
84
|
+
"env": {
|
|
85
|
+
"SMSMASIVOS_API_KEY": "tu-api-key"
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Usando Bun (alternativa mas rapida)
|
|
93
|
+
|
|
94
|
+
Si tienes [Bun](https://bun.sh) instalado, reemplaza `npx` por `bunx` en cualquier configuracion:
|
|
95
|
+
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"command": "bunx",
|
|
99
|
+
"args": ["-y", "@smsmasivos/mcp-server"]
|
|
100
|
+
}
|
|
101
|
+
```
|
|
50
102
|
|
|
51
103
|
## Tools disponibles
|
|
52
104
|
|
|
@@ -54,22 +106,24 @@ Agrega el MCP server en la configuracion de tu editor con los mismos parametros.
|
|
|
54
106
|
|------|-------------|
|
|
55
107
|
| `check_balance` | Consulta creditos SMS disponibles |
|
|
56
108
|
| `send_sms` | Envia SMS a uno o varios numeros (max 500) |
|
|
57
|
-
| `
|
|
109
|
+
| `list_campaigns` | Lista campanas con filtros por fecha |
|
|
110
|
+
| `get_campaign_stats` | Estadisticas de entrega de una campana |
|
|
111
|
+
| `list_agendas` | Lista agendas de contactos |
|
|
58
112
|
| `get_contacts` | Obtiene contactos de una agenda |
|
|
59
113
|
| `add_contact` | Agrega contacto a una agenda |
|
|
60
|
-
| `
|
|
61
|
-
| `verify_phone` | Inicia verificacion OTP por SMS/voz/WhatsApp |
|
|
114
|
+
| `verify_phone` | Inicia verificacion OTP (SMS, voz o WhatsApp) |
|
|
62
115
|
| `check_verification` | Verifica codigo OTP |
|
|
63
116
|
|
|
64
117
|
## Ejemplos
|
|
65
118
|
|
|
66
|
-
Una vez configurado, puedes pedirle a
|
|
119
|
+
Una vez configurado, puedes pedirle a tu asistente:
|
|
67
120
|
|
|
68
121
|
- "Cuantos creditos me quedan?"
|
|
69
122
|
- "Envia un SMS al 5512345678 con el texto: Tu cita es manana a las 10am"
|
|
70
|
-
- "Muestrame mis
|
|
71
|
-
- "Como fue la entrega de
|
|
72
|
-
- "Verifica el numero 5598765432 por
|
|
123
|
+
- "Muestrame mis ultimas campanas"
|
|
124
|
+
- "Como fue la entrega de la campana 12345?"
|
|
125
|
+
- "Verifica el numero 5598765432 por WhatsApp"
|
|
126
|
+
- "Agrega a Juan (5512345678) a mi agenda de recordatorios"
|
|
73
127
|
|
|
74
128
|
## Desarrollo
|
|
75
129
|
|