Conecta un agente de IA a tus décimos con MCP
Añade https://api.tudecimo.com/mcp en tu IA (Claude, ChatGPT, Claude Code, Codex o Cursor), pulsa Conectar e inicia sesión: es gratis con tu cuenta, en todos los planes (en Gratis, hasta 50 décimos activos desde la IA; con cualquier plan de pago, ilimitados). Tu IA puede ver tus décimos, apuntar uno y crear el enlace para compartirlo; nunca paga, cobra ni escribe a otras personas. Sin cuenta, https://api.tudecimo.com/mcp/publico comprueba números y resultados.
Añade https://api.tudecimo.com/mcp en tu IA, pulsa Conectar e inicia sesión: gratis con tu cuenta, en todos los planes. Tu IA podrá ver tus décimos, apuntar uno nuevo y crear el enlace para compartirlo. Nunca paga, cobra ni escribe a otras personas: eso se sigue haciendo en la web o en la app.
Qué puede hacer un agente con TuDécimo
Sin cuenta, un asistente de IA puede usar 4 herramientas públicas (sorteos, resultados, comprobar números y dónde se vende un número) en https://api.tudecimo.com/mcp/publico. Conectado con tu cuenta (inicio de sesión, gratis) dispone de todas las herramientas del MCP:
Sorteos y resultados
Próximos sorteos y resultados oficiales (Navidad, El Niño, Nacional, Euromillones, Primitiva, Bonoloto, El Gordo).
Comprobar números
Si un número tiene premio en un sorteo y cuánto corresponde por décimo, y dónde se vende un número de Navidad o El Niño.
Ver tus décimos
Tus décimos, participaciones y peñas, con su estado y su premio si ya se ha comprobado, y un resumen de tu cuenta.
Apuntar un décimo propio
Registrar un décimo tuyo (número, sorteo, importe) y cambiar su alias o nota. No avisa a nadie.
Compartir un décimo con un enlace
Crea el enlace para compartir tu décimo y te da el mensaje para WhatsApp. Tú lo envías; cada persona se apunta ella misma.
Qué no puede hacer nunca, y por qué
Esto no es una promesa del agente: lo comprueba el servidor para cualquier conexión o clave, aunque tenga todos los permisos.
El agente sí puede
- Consultar sorteos, resultados y comprobar números
- Ver tus décimos, participaciones, peñas y un resumen de la cuenta
- Apuntar un décimo propio y cambiar su alias o nota
- Crear el enlace para compartir un décimo y darte el mensaje para WhatsApp
El agente nunca puede
- Pagar, cobrar o marcar una deuda como pagada: mueve dinero
- Contratar, cambiar o cancelar una suscripción: mueve dinero
- Crear una participación o responder a una invitación: crea una deuda entre personas
- Crear o borrar un contrato, o borrar cualquier dato: documento legal o acción destructiva
- Invitar o escribir a un contacto, a una peña o a otro usuario: mensajes a terceros
Cómo conectar Claude, ChatGPT, Claude Code, Codex y Cursor
Es siempre igual: añade https://api.tudecimo.com/mcp en tu IA, pulsa Conectar e inicia sesión en TuDécimo. Es gratis con tu cuenta, sin clave y en todos los planes. Puedes desconectarla cuando quieras en Conexiones de IA.
Claude.ai, Claude Desktop y Claude Code
En Claude.ai y Claude Desktop: Ajustes → Conectores → Añadir conector personalizado, pega la URL y pulsa Conectar.
En Claude Code: claude mcp add --transport http tudecimo https://api.tudecimo.com/mcp y después /mcp → Authenticate.
ChatGPT
Ajustes → Conectores (o Apps), activa el modo desarrollador, crea un conector con la URL y pulsa Conectar.
Codex
codex mcp add tudecimo --url https://api.tudecimo.com/mcp y después codex mcp login tudecimo.
Cursor
Añade a mcp.json el servidor con "url": "https://api.tudecimo.com/mcp" y pulsa Connect.
Cosas que puedes pedirle una vez conectada:
- «Apunta mi décimo 12345 de Navidad»
- «Comparte mi décimo 12345 a 5 € la participación y dame el mensaje para WhatsApp»
- «¿Me ha tocado algo?»
¿Sin cuenta? Usa https://api.tudecimo.com/mcp/publico: resultados y comprobar números, gratis y con límite por IP.
claude mcp add --transport http tudecimo-publico https://api.tudecimo.com/mcp/publicoOpción avanzada: clave de agente. Si prefieres una clave (td_live_…, plan Ilimitado, creada en /api-keys) puedes pasarla en la cabecera Authorization: Bearer <clave>. Para el resto no la necesitas. También puedes usar el comprobador de Tu Décimo o seguir la guía de comprobar la lotería con un asistente.
Ejemplo real de una conversación
Con el servidor conectado, preguntas en lenguaje normal y el asistente llama a las herramientas por ti.
Tú
¿Ha tocado algo el 12345 en el sorteo de Navidad?
El asistente
Llama a list_draws para localizar el sorteo y a check_number con el número. Después te cuenta el resultado: si tiene premio y cuánto corresponde por décimo, o que no ha tenido premio. No compra, no cobra ni avisa a nadie.
API pública para desarrolladores
Los mismos datos están en una API REST con clave de agente (plan Ilimitado, cabecera Authorization: Bearer). Por ejemplo, para comprobar un número en un sorteo ya finalizado:
curl -H "Authorization: Bearer $TUDECIMO_API_KEY" "https://api.tudecimo.com/v1/public/comprobar?sorteoId=SORTEO_ID&numero=12345" La respuesta tiene esta forma (estado es won, not-won, partial-match o not-supported; los valores de abajo son de relleno):
{
"sorteoId": "SORTEO_ID",
"tipoLoteria": "navidad",
"numero": "12345",
"estado": "not-won",
"resultado": null
}Referencia completa de endpoints, límites y errores en la documentación de la API y en la especificación OpenAPI.
Límites según tu plan
Conectar tu IA con tu cuenta es gratis en todos los planes; cuanto mejor es tu plan, más peticiones al día puede hacer tu IA. Con el plan Gratis tu IA puede trabajar con hasta 50 décimos activos en total (los de la web, la app y la IA); con cualquier plan de pago, ilimitados. Consultar es siempre libre. Las claves de agente (opción avanzada) son del plan Ilimitado.
| Plan | Acceso de agente | Claves | Por minuto | Por día | Décimos activos desde la IA |
|---|---|---|---|---|---|
| Gratis | Conexión con tu cuenta (lectura y escritura) | — | 20 | 300 | 50 |
| Básico | Conexión con tu cuenta (lectura y escritura) | — | 30 | 1 000 | ilimitados |
| Pro | Conexión con tu cuenta (lectura y escritura) | — | 60 | 5 000 | ilimitados |
| Ilimitado (19,99 €/mes · IVA incluido) | Conexión con tu cuenta y claves de agente (agent:read + agent:write) | hasta 10 | hasta 300 | hasta 50 000 | ilimitados |
Consulta tus conexiones en /api-keys o mejora tu plan en /premium.
Preguntas frecuentes sobre los agentes de IA
¿Qué es el MCP de TuDécimo?
MCP (Model Context Protocol) es un estándar abierto para conectar asistentes de IA con aplicaciones. El servidor MCP de TuDécimo deja que Claude, Cursor y otros clientes compatibles consulten tus décimos y los sorteos con tu clave de agente, sin que tengas que programar nada.
¿Qué puede hacer un agente de IA con mi cuenta?
Consultar sorteos y resultados, comprobar si un número tiene premio, ver tus décimos, participaciones y peñas, apuntar un décimo propio o cambiarle el alias, y crear el enlace para compartir un décimo (te devuelve el enlace y el mensaje para WhatsApp; tú lo envías). Nada más.
¿Puede un agente pagar o avisar a mis contactos?
No. El agente nunca paga, cobra, marca una deuda como pagada, gestiona una suscripción, crea una participación ni escribe a otra persona. El servidor rechaza esas acciones aunque la conexión o la clave tengan todos los permisos.
¿Cómo conecto Claude Code, Codex o Cursor?
Añade https://api.tudecimo.com/mcp en tu IA, pulsa Conectar e inicia sesión en TuDécimo: es gratis con tu cuenta. En Claude Code: claude mcp add --transport http tudecimo https://api.tudecimo.com/mcp y luego /mcp → Authenticate. En Codex: codex mcp add tudecimo --url https://api.tudecimo.com/mcp y codex mcp login tudecimo. En Cursor, una entrada con "url" en mcp.json. En Claude.ai y Claude Desktop: Ajustes → Conectores → Añadir conector personalizado. No hace falta instalar nada ni crear claves.
¿Funciona con ChatGPT?
Sí, en modo desarrollador: en Ajustes → Conectores (o Apps) crea un conector con la URL https://api.tudecimo.com/mcp, pulsa Conectar e inicia sesión en TuDécimo. No está en el directorio de ChatGPT.
¿Necesito una clave o una cuenta para comprobar un número desde un asistente?
No. En https://api.tudecimo.com/mcp/publico las herramientas públicas (list_draws, get_draw_results, check_number y find_selling_points) funcionan sin cuenta ni clave y gratis, con un límite por IP. Para ver tus décimos, participaciones y peñas conecta tu IA con tu cuenta (gratis); no hace falta ninguna clave.
¿Hay límite de décimos con la IA?
Con el plan Gratis, tu IA puede trabajar con hasta 50 décimos activos en total (cuentan los que ya tengas de la web, la app o la IA): al llegar a 50 no puede apuntar más ni crear enlaces de compartir nuevos, pero sigue pudiendo consultar. Con cualquier plan de pago (Básico desde 2,99 €/mes, Pro o Ilimitado) los décimos desde la IA son ilimitados. En la web y la app los décimos siguen siendo ilimitados en Gratis.
¿Qué plan necesito?
Ninguno: conectar tu IA con tu cuenta es gratis en todos los planes; en Gratis la IA llega hasta 50 décimos activos y con cualquier plan de pago es ilimitada. Cambia también el límite diario de peticiones (Gratis 300, Básico 1 000, Pro 5 000, Ilimitado más). Las claves de agente, una opción avanzada, son del plan Ilimitado (19,99 €/mes o 159,90 €/año, IVA incluido). Revísalo en /premium.
Deja que tu asistente consulte la lotería por ti
Añade la URL en tu IA, pulsa Conectar e inicia sesión: gratis con tu cuenta, sin claves.
También te puede interesar
Claves de API y de agente
Gestiona tus conexiones de IA y tus claves de agente.
API pública
Documentación de la API para desarrolladores.
Comprobar la lotería con un asistente
Qué puede hacer de verdad ChatGPT o Claude con tu décimo.
Precios
Conectar tu IA es gratis en todos los planes; las claves, en Ilimitado.
Todas las funciones
Todo lo que puedes hacer con TuDécimo.