@smsmasivos/mcp-server 0.3.0 → 0.3.2

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.
Files changed (3) hide show
  1. package/README.md +134 -24
  2. package/dist/stdio.js +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -9,30 +9,80 @@ Conecta tu asistente de IA con SMS Masivos para enviar mensajes, gestionar conta
9
9
 
10
10
  ## Features
11
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
12
+ - **19 tools** — SMS, campanas, contactos, verificacion OTP, lealtad, monederos y metricas
13
+ - **FAQ integrado** — 5 recursos de ayuda accesibles desde tu asistente
14
+ - **Prompts guiados** — 4 flujos paso a paso para tareas comunes
15
+ - **Telemetria** — metricas de uso por sesion (latencia, errores, sandbox vs produccion)
16
16
  - **Sandbox** — prueba sin enviar mensajes reales ni gastar creditos
17
17
  - **Compatible** — funciona con Claude, Cursor, Windsurf y cualquier cliente MCP
18
18
 
19
19
  ## Quick Start
20
20
 
21
+ Necesitas una API key de SMS Masivos. Obtenla en [tu panel](https://app.smsmasivos.com.mx).
22
+
23
+ ### Opcion 1: Remoto (recomendado — sin instalar nada)
24
+
25
+ Agrega esta configuracion a tu herramienta de IA y listo:
26
+
27
+ ```json
28
+ {
29
+ "mcpServers": {
30
+ "smsmasivos": {
31
+ "type": "http",
32
+ "url": "https://mcp.smsmasivos.com.mx/mcp",
33
+ "headers": {
34
+ "Authorization": "Bearer tu-api-key"
35
+ }
36
+ }
37
+ }
38
+ }
39
+ ```
40
+
41
+ ### Opcion 2: Local (requiere Node.js)
42
+
21
43
  ```bash
22
44
  npx @smsmasivos/mcp-server
23
45
  ```
24
46
 
25
- Necesitas una API key de SMS Masivos. Obtenla en [tu panel](https://app.smsmasivos.com.mx).
47
+ ```json
48
+ {
49
+ "mcpServers": {
50
+ "smsmasivos": {
51
+ "command": "npx",
52
+ "args": ["-y", "@smsmasivos/mcp-server"],
53
+ "env": {
54
+ "SMSMASIVOS_API_KEY": "tu-api-key"
55
+ }
56
+ }
57
+ }
58
+ }
59
+ ```
26
60
 
27
- ## Configuracion
61
+ ## Configuracion por herramienta
28
62
 
29
63
  ### Claude Desktop
30
64
 
31
- Agrega esto a tu archivo de configuracion:
65
+ Agrega a tu archivo de configuracion:
32
66
 
33
67
  - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
34
68
  - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
35
69
 
70
+ **Remoto (recomendado):**
71
+ ```json
72
+ {
73
+ "mcpServers": {
74
+ "smsmasivos": {
75
+ "type": "http",
76
+ "url": "https://mcp.smsmasivos.com.mx/mcp",
77
+ "headers": {
78
+ "Authorization": "Bearer tu-api-key"
79
+ }
80
+ }
81
+ }
82
+ }
83
+ ```
84
+
85
+ **Local:**
36
86
  ```json
37
87
  {
38
88
  "mcpServers": {
@@ -49,6 +99,12 @@ Agrega esto a tu archivo de configuracion:
49
99
 
50
100
  ### Claude Code
51
101
 
102
+ **Remoto (recomendado):**
103
+ ```bash
104
+ claude mcp add smsmasivos --transport http https://mcp.smsmasivos.com.mx/mcp -H "Authorization: Bearer tu-api-key"
105
+ ```
106
+
107
+ **Local:**
52
108
  ```bash
53
109
  claude mcp add smsmasivos -e SMSMASIVOS_API_KEY=tu-api-key -- npx -y @smsmasivos/mcp-server
54
110
  ```
@@ -57,24 +113,22 @@ claude mcp add smsmasivos -e SMSMASIVOS_API_KEY=tu-api-key -- npx -y @smsmasivos
57
113
 
58
114
  Agrega a `.cursor/mcp.json` en tu proyecto:
59
115
 
116
+ **Remoto (recomendado):**
60
117
  ```json
61
118
  {
62
119
  "mcpServers": {
63
120
  "smsmasivos": {
64
- "command": "npx",
65
- "args": ["-y", "@smsmasivos/mcp-server"],
66
- "env": {
67
- "SMSMASIVOS_API_KEY": "tu-api-key"
121
+ "type": "http",
122
+ "url": "https://mcp.smsmasivos.com.mx/mcp",
123
+ "headers": {
124
+ "Authorization": "Bearer tu-api-key"
68
125
  }
69
126
  }
70
127
  }
71
128
  }
72
129
  ```
73
130
 
74
- ### Windsurf
75
-
76
- Agrega a `~/.codeium/windsurf/mcp_config.json`:
77
-
131
+ **Local:**
78
132
  ```json
79
133
  {
80
134
  "mcpServers": {
@@ -89,31 +143,84 @@ Agrega a `~/.codeium/windsurf/mcp_config.json`:
89
143
  }
90
144
  ```
91
145
 
92
- ### Usando Bun (alternativa mas rapida)
146
+ ### Windsurf
93
147
 
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
- ```
148
+ Agrega a `~/.codeium/windsurf/mcp_config.json` — misma configuracion que Cursor (remoto o local).
102
149
 
103
150
  ## Tools disponibles
104
151
 
152
+ ### SMS y campanas
153
+
105
154
  | Tool | Descripcion |
106
155
  |------|-------------|
107
156
  | `check_balance` | Consulta creditos SMS disponibles |
108
157
  | `send_sms` | Envia SMS a uno o varios numeros (max 500) |
109
158
  | `list_campaigns` | Lista campanas con filtros por fecha |
110
159
  | `get_campaign_stats` | Estadisticas de entrega de una campana |
160
+
161
+ ### Contactos y agendas
162
+
163
+ | Tool | Descripcion |
164
+ |------|-------------|
111
165
  | `list_agendas` | Lista agendas de contactos |
112
166
  | `get_contacts` | Obtiene contactos de una agenda |
113
167
  | `add_contact` | Agrega contacto a una agenda |
168
+ | `delete_contact` | Elimina un contacto de una agenda |
169
+
170
+ ### Verificacion OTP
171
+
172
+ | Tool | Descripcion |
173
+ |------|-------------|
114
174
  | `verify_phone` | Inicia verificacion OTP (SMS, voz o WhatsApp) |
115
175
  | `check_verification` | Verifica codigo OTP |
116
176
 
177
+ ### Programa de lealtad
178
+
179
+ | Tool | Descripcion |
180
+ |------|-------------|
181
+ | `list_loyalty_cards` | Lista tarjetas de lealtad de tu cuenta |
182
+ | `add_loyalty_contact` | Agrega contacto a una tarjeta de lealtad |
183
+ | `get_loyalty_contact` | Consulta sellos y canjes de un contacto |
184
+ | `register_loyalty_sale` | Registra venta y agrega sellos |
185
+
186
+ ### Monedero electronico
187
+
188
+ | Tool | Descripcion |
189
+ |------|-------------|
190
+ | `list_wallets` | Lista monederos de tu cuenta |
191
+ | `add_wallet_contact` | Agrega contacto a un monedero |
192
+ | `get_wallet_contact` | Consulta saldo de un contacto |
193
+ | `update_wallet_balance` | Agrega o resta saldo a un contacto |
194
+
195
+ ### Utilidades
196
+
197
+ | Tool | Descripcion |
198
+ |------|-------------|
199
+ | `get_metrics` | Metricas de uso de la sesion (latencia, errores, sandbox vs prod) |
200
+
201
+ ## FAQ Resources
202
+
203
+ El servidor incluye 5 recursos de ayuda accesibles via MCP resources:
204
+
205
+ | Resource | Descripcion |
206
+ |----------|-------------|
207
+ | `getting-started` | Como obtener tu API key y configurar el server |
208
+ | `common-errors` | Errores frecuentes y como solucionarlos |
209
+ | `limits-and-pricing` | Limites de la API y precios |
210
+ | `sandbox-mode` | Como usar el modo sandbox para pruebas |
211
+ | `tool-examples` | Ejemplos de uso de cada tool |
212
+
213
+ ## Prompts guiados
214
+
215
+ Flujos paso a paso que tu asistente puede ejecutar:
216
+
217
+ | Prompt | Descripcion |
218
+ |--------|-------------|
219
+ | `enviar-campana` | Verificar saldo, enviar SMS y consultar estadisticas |
220
+ | `consultar-lealtad` | Listar tarjetas y consultar sellos de clientes |
221
+ | `gestionar-contactos` | Ver agendas, contactos y agregar nuevos |
222
+ | `verificar-numero` | Enviar codigo OTP y validarlo |
223
+
117
224
  ## Ejemplos
118
225
 
119
226
  Una vez configurado, puedes pedirle a tu asistente:
@@ -124,6 +231,9 @@ Una vez configurado, puedes pedirle a tu asistente:
124
231
  - "Como fue la entrega de la campana 12345?"
125
232
  - "Verifica el numero 5598765432 por WhatsApp"
126
233
  - "Agrega a Juan (5512345678) a mi agenda de recordatorios"
234
+ - "Muestrame mis tarjetas de lealtad"
235
+ - "Cuantos sellos tiene el cliente 5512345678?"
236
+ - "Agrega $50 al monedero del cliente 5598765432"
127
237
 
128
238
  ## Desarrollo
129
239
 
package/dist/stdio.js CHANGED
File without changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@smsmasivos/mcp-server",
3
- "version": "0.3.0",
3
+ "version": "0.3.2",
4
4
  "description": "MCP server for SMS Masivos — bulk SMS platform for Mexico",
5
5
  "type": "module",
6
6
  "main": "dist/stdio.js",