@smsmasivos/mcp-server 0.3.0 → 0.3.1

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 (2) hide show
  1. package/README.md +67 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -9,10 +9,10 @@ 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
 
@@ -102,18 +102,78 @@ Si tienes [Bun](https://bun.sh) instalado, reemplaza `npx` por `bunx` en cualqui
102
102
 
103
103
  ## Tools disponibles
104
104
 
105
+ ### SMS y campanas
106
+
105
107
  | Tool | Descripcion |
106
108
  |------|-------------|
107
109
  | `check_balance` | Consulta creditos SMS disponibles |
108
110
  | `send_sms` | Envia SMS a uno o varios numeros (max 500) |
109
111
  | `list_campaigns` | Lista campanas con filtros por fecha |
110
112
  | `get_campaign_stats` | Estadisticas de entrega de una campana |
113
+
114
+ ### Contactos y agendas
115
+
116
+ | Tool | Descripcion |
117
+ |------|-------------|
111
118
  | `list_agendas` | Lista agendas de contactos |
112
119
  | `get_contacts` | Obtiene contactos de una agenda |
113
120
  | `add_contact` | Agrega contacto a una agenda |
121
+ | `delete_contact` | Elimina un contacto de una agenda |
122
+
123
+ ### Verificacion OTP
124
+
125
+ | Tool | Descripcion |
126
+ |------|-------------|
114
127
  | `verify_phone` | Inicia verificacion OTP (SMS, voz o WhatsApp) |
115
128
  | `check_verification` | Verifica codigo OTP |
116
129
 
130
+ ### Programa de lealtad
131
+
132
+ | Tool | Descripcion |
133
+ |------|-------------|
134
+ | `list_loyalty_cards` | Lista tarjetas de lealtad de tu cuenta |
135
+ | `add_loyalty_contact` | Agrega contacto a una tarjeta de lealtad |
136
+ | `get_loyalty_contact` | Consulta sellos y canjes de un contacto |
137
+ | `register_loyalty_sale` | Registra venta y agrega sellos |
138
+
139
+ ### Monedero electronico
140
+
141
+ | Tool | Descripcion |
142
+ |------|-------------|
143
+ | `list_wallets` | Lista monederos de tu cuenta |
144
+ | `add_wallet_contact` | Agrega contacto a un monedero |
145
+ | `get_wallet_contact` | Consulta saldo de un contacto |
146
+ | `update_wallet_balance` | Agrega o resta saldo a un contacto |
147
+
148
+ ### Utilidades
149
+
150
+ | Tool | Descripcion |
151
+ |------|-------------|
152
+ | `get_metrics` | Metricas de uso de la sesion (latencia, errores, sandbox vs prod) |
153
+
154
+ ## FAQ Resources
155
+
156
+ El servidor incluye 5 recursos de ayuda accesibles via MCP resources:
157
+
158
+ | Resource | Descripcion |
159
+ |----------|-------------|
160
+ | `getting-started` | Como obtener tu API key y configurar el server |
161
+ | `common-errors` | Errores frecuentes y como solucionarlos |
162
+ | `limits-and-pricing` | Limites de la API y precios |
163
+ | `sandbox-mode` | Como usar el modo sandbox para pruebas |
164
+ | `tool-examples` | Ejemplos de uso de cada tool |
165
+
166
+ ## Prompts guiados
167
+
168
+ Flujos paso a paso que tu asistente puede ejecutar:
169
+
170
+ | Prompt | Descripcion |
171
+ |--------|-------------|
172
+ | `enviar-campana` | Verificar saldo, enviar SMS y consultar estadisticas |
173
+ | `consultar-lealtad` | Listar tarjetas y consultar sellos de clientes |
174
+ | `gestionar-contactos` | Ver agendas, contactos y agregar nuevos |
175
+ | `verificar-numero` | Enviar codigo OTP y validarlo |
176
+
117
177
  ## Ejemplos
118
178
 
119
179
  Una vez configurado, puedes pedirle a tu asistente:
@@ -124,6 +184,9 @@ Una vez configurado, puedes pedirle a tu asistente:
124
184
  - "Como fue la entrega de la campana 12345?"
125
185
  - "Verifica el numero 5598765432 por WhatsApp"
126
186
  - "Agrega a Juan (5512345678) a mi agenda de recordatorios"
187
+ - "Muestrame mis tarjetas de lealtad"
188
+ - "Cuantos sellos tiene el cliente 5512345678?"
189
+ - "Agrega $50 al monedero del cliente 5598765432"
127
190
 
128
191
  ## Desarrollo
129
192
 
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.1",
4
4
  "description": "MCP server for SMS Masivos — bulk SMS platform for Mexico",
5
5
  "type": "module",
6
6
  "main": "dist/stdio.js",