Subtraq

npx add-mcp 'https://subtraq.co/api/mcp'

Un endpoint, ocho herramientas, y tu agente sabe qué se vendió.

Tu agente ya habla MCP. El nuestro es un endpoint, ocho herramientas y autenticación por clave API: el protocolo se encarga del resto. Abres el espacio de trabajo en el plan gratuito, sin tarjeta de crédito.

Tres letras, cero SDK

MCP

El protocolo para tus agentes de IA

Model Context Protocol: el conector estándar entre un agente y una herramienta. Sin librería que instalar, sin envoltorio que mantener: una URL, una clave, y el agente descubre las herramientas por sí solo.

Lo que el agente controla, en capturas

8 herramientas expuestas al agente

Esta lista se importa del registro que el servidor realmente expone: cuando una herramienta cambia, esta página cambia con ella.

list_spaces

Lista los espacios de trabajo de la cuenta. Un espacio de trabajo = un cliente, marca o proyecto; todo lo demás (enlaces, clics, ventas) vive dentro de él.

create_space

Crea un espacio de trabajo de cliente. Se rechaza con el código space\_limit\_reached\ cuando el plan está lleno.

list_links

Lista enlaces. Un enlace PADRE lleva el destino; un PLACEMENT (subenlace) lleva los UTM de una publicación específica y hereda el resto.

create_link

Crea un enlace corto. Sin parentId\ es un enlace padre y se requiere destination\. Con parentId\ es un placement: hereda el destino del padre y lleva sus propios UTM. Devuelve shortUrl\, listo para publicar.

get_link

Detalla un enlace: su destino FINAL (UTM incluidos, exactamente como lo recibe el sitio de destino) y sus clics durante 30 días.

update_link

Cambia el destino, la etiqueta o la DIRECCIÓN de un enlace (domain\ y/o slug\), o lo archiva. Cambiar la dirección no rompe nada: la dirección antigua sigue redirigiendo al mismo lugar y sus clics cuentan en este enlace (previousShortUrls\); los placements que compartían su dominio lo siguen. Un enlace NUNCA se elimina: archivado, deja de redirigir (direcciones antiguas incluidas) pero su historial permanece.

get_analytics

Los números de un espacio de trabajo: clics, leads, ventas, ingresos ATRIBUIDOS e ingresos NO ATRIBUIDOS, más el detalle placement por placement. Montos en CÉNTIMOS. Subtraq no convierte monedas: si mixedCurrencies\ es verdadero, los totales solo cubren currency\. model\ elige cómo se lee la atribución; la respuesta siempre indica cuál se usó.

track_sale

Registra una VENTA y la vincula al placement de origen de la persona. Monto en CÉNTIMOS. invoiceId\ hace la llamada idempotente: reproducirla nunca cobra dos veces. Una venta NO se puede enviar desde un navegador.

Tres tareas. El agente las maneja mejor.

El enlace en medio de la conversación

"Crea un enlace a la página promocional, canal newsletter, espacio de trabajo Lartigue": el agente llama a create_link y coloca la URL corta en tu borrador.

El resumen del lunes por la mañana

"¿Qué generó ingresos esta semana, cliente por cliente?" — el agente encadena list_spaces y get_analytics y responde en lenguaje natural, no en una tabla.

La venta fuera de línea

¿Un contrato firmado por teléfono? "Registra $2,400 para el enlace del stand" — track_sale, y la atribución está completa.

Lo que el agente lee: atribución y ROAS

Una API documentada con OpenAPI

El servidor MCP y la API v1 comparten el mismo registro: ocho herramientas, una sola verdad. Tus scripts existentes usan la API; tus agentes usan el MCP; nadie espera otra "integración de IA".

GET /api/v1/openapi.json

El contrato completo, generado desde el mismo registro de herramientas. Lo que el MCP expone, la API lo expone: nunca uno sin el otro.

8

herramientas, idénticas entre MCP y API

1

clave API: la misma para ambos

0

SDK que instalar en el lado del agente

Preguntas frecuentes

¿Con qué agentes funciona?

Con cualquier cliente MCP: Claude (Desktop y Code), y cualquier otro cliente compatible con el protocolo. El servidor habla MCP estándar — initialize, tools/list, tools/call — sin extensiones propietarias.

¿Puede un agente romper algo?

Hace exactamente lo que su clave API permite, dentro del espacio de trabajo de esa clave. No se expone eliminación masiva: las herramientas crean, leen y actualizan. Cada llamada se registra como cualquier llamada API normal.

¿Qué plan lo incluye?

La API y el MCP están vinculados a la clave API de tu espacio de trabajo. La creación de claves está disponible en el producto: los límites de tu plan se aplican a los enlaces creados, sin importar de dónde provengan.

¿Por qué un acortador necesita MCP?

Porque el trabajo alrededor de los enlaces es conversacional: escribes un newsletter, preparas una campaña, haces una revisión de cliente. El agente ya está en la conversación — bien puede crear los enlaces y leer los números sin cambiar de pestaña.