Agentes de IA

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/publico

Opció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.

PlanAcceso de agenteClavesPor minutoPor díaDécimos activos desde la IA
GratisConexión con tu cuenta (lectura y escritura)—2030050
BásicoConexión con tu cuenta (lectura y escritura)—301 000ilimitados
ProConexión con tu cuenta (lectura y escritura)—605 000ilimitados
Ilimitado (19,99 €/mes · IVA incluido)Conexión con tu cuenta y claves de agente (agent:read + agent:write)hasta 10hasta 300hasta 50 000ilimitados

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.