Tillpad

Almacenamiento limitado y búsqueda para trabajos de agentes

Documentación

Tillpad MCP

Almacenamiento acotado y búsqueda para trabajos de agentes.

Tillpad ofrece a los agentes almacenamiento de clave-valor con espacios de nombres, carga de archivos + búsqueda semántica, buzones de correo de solo recepción, medición de uso consciente del presupuesto y claves de ejecución que se eliminan con un recibo firmado cuando el trabajo termina.

Endpoint en vivo: https://tillpad.cnrcode.com/mcp

Este repositorio es el catálogo público y stub de esquema para rastreadores de directorios. No es el servidor alojado. Apunta los clientes MCP a la URL en vivo de arriba con una clave API de Tillpad. Ejecutar el TypeScript en este repositorio no almacena ni busca nada.

Guía para agentes: consulta AGENTS.md para URLs de descubrimiento, autenticación y fragmentos de conexión MCP.

Obtén una clave API

Ruta sin humanos (agentes)

POST https://tillpad.cnrcode.com/api/agents/bootstrap con { "email": "agent@example.com" } → bootstrapToken (sin correo saliente).
POST https://tillpad.cnrcode.com/api/billing/machine-pay con Authorization: Bearer <bootstrapToken> y { "sku": "pro_prepaid_30d" } opcional.
Liquida Stripe MPP ($9.00 / 30 días) → la respuesta incluye secret (tp_…) y planPeriodEnd.

Consulta scratchpad.txt y llms-full.txt. Legal: Términos.

Ruta humana

Abre tillpad.cnrcode.com y crea una cuenta.
Suscríbete a Tillpad Pro en Precios, luego genera una clave API en el panel. Los secretos comienzan con tp_.
Usa una clave de cuenta para acceso continuo, o una clave de ejecución cuando el trabajo deba expirar y eliminarse.

Nunca confirmes una clave real. Usa el marcador de posición tp_… en las configuraciones.

Conecta un cliente

El transporte es Streamable HTTP. Envía Authorization: Bearer tp_… en cada solicitud.

Cursor

Instalación vía Cursor Marketplace (plugin)

Este repositorio incluye un manifiesto de plugin de Cursor y un mcp.json raíz para instalación con un clic desde el Cursor Marketplace.

Las herramientas MCP de Tillpad cubren KVP con espacios de nombres, búsqueda RAG, buzones de correo de solo recepción, trabajos HTTPS programados, medición de presupuesto y recibos de eliminación con clave de ejecución.

Instala el plugin Tillpad desde el marketplace (o pruébalo localmente — ver abajo).
Abre Cursor Settings → Customize → Tillpad y establece la clave API de Tillpad (tp_… del bootstrap + pago automático o el panel).
Recarga la ventana. Las herramientas MCP deberían aparecer bajo el servidor Tillpad.

El plugin apunta a https://tillpad.cnrcode.com/mcp con Authorization: Bearer ${TILLPAD_API_KEY}. Nunca confirmes una clave real.

Prueba local del plugin (antes del envío al marketplace):

# Copy catalog repo into Cursor local plugins folder
$dest = "$env:USERPROFILE\.cursor\plugins\local\tillpad"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item -Recurse -Force "C:\dev\tillpad\tillpad-mcp\*" $dest
# Then: Cursor Customize → Tillpad → set TILLPAD_API_KEY → Developer: Reload Window

Envía el repositorio público en cursor.com/marketplace/publish cuando esté listo.

Configuración MCP manual

Configuración MCP de usuario o proyecto:

{
  "mcpServers": {
    "tillpad": {
      "url": "https://tillpad.cnrcode.com/mcp",
      "headers": {
        "Authorization": "Bearer tp_…"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "tillpad": {
      "command": "npx",
      "args": ["mcp-remote", "https://tillpad.cnrcode.com/mcp", "--header", "Authorization: Bearer tp_…"]
    }
  }
}

MCP remoto genérico

{
  "url": "https://tillpad.cnrcode.com/mcp",
  "headers": {
    "Authorization": "Bearer tp_…"
  }
}

Manifiestos de descubrimiento en el host del producto:

Herramientas

Los esquemas en src/server.ts coinciden con el servidor alojado.

Herramienta	Qué hace
`get_usage`	Uso de un mes (`view=summary`), historial paginado (`view=periods`) o cuotas restantes (`view=budget`)
`estimate_usage`	Verificación previa 402/429 antes de un gasto medido (`textLength` / `byteLength` para `rag_index`)
`manage_billing`	Instrucciones de pago automático MPP (`action=machine_pay`), URL del portal de Stripe o historial de compras
`bootstrap_agent`	Incorporación sin humanos: token de bootstrap desde correo (sin correo saliente)
`create_api_key`	Genera una clave de ejecución o subclave desde una clave de cuenta `tp_`
`manage_kv`	Poner, obtener, eliminar o listar una cadena con espacio de nombres
`manage_memory`	Poner u obtener alcance de memoria `prefs` / `facts` / `run`
`search_documents`	Búsqueda semántica sobre documentos indexados o un alcance de memoria
`index_document`	Indexar un archivo UTF-8 nombrado (`kind=file`) o una nota corta (`kind=note`)
`list_files`	Listar cargas (`view=files`) o tipos admitidos (`view=supported_types`)
`get_storage_summary`	Inventario de espacios de nombres (limitado a la clave cuando corresponda)
`finish_run`	Elimina espacios de nombres vinculados a esta clave de ejecución; devuelve un recibo de eliminación firmado
`contact_support`	Contacta al soporte de Tillpad desde una cuenta Pro; las respuestas van al correo de la cuenta
`manage_inbox`	Crear, listar, obtener, eliminar o auditar buzones de solo recepción
`read_inbox_message`	Listar metadatos, obtener un mensaje, descargar MIME crudo u obtener un adjunto
`manage_inbox_webhook`	Registrar, listar, deshabilitar o inspeccionar entregas de webhook `email.received`
`manage_inbox_blocklist`	Listar, agregar o eliminar una dirección o dominio de remitente bloqueado
`manage_schedule`	Crear, listar, obtener, deshabilitar o listar ejecuciones para trabajos de intervalo HTTPS

Bucle típico de agente

Genera una clave de ejecución con create_api_key (o el panel): espacio de nombres dedicado, TTL, presupuesto de operaciones opcional.
Almacena el estado de trabajo con manage_memory / manage_kv y/o index_document.
Recupera con manage_memory / manage_kv y search_documents.
Llama a finish_run para eliminar los espacios de nombres de ejecución y conservar el recibo firmado.

Usa estimate_usage antes de trabajos de indexación grandes. get_usage muestra lo que queda en el período.

Autenticación y errores

401 — falta o es inválida la Authorization: Bearer tp_…
402 / 429 — plan o cuota. El JSON incluye code, status, actions y budget
- actions[].type: "checkout" — URL alojada de Stripe Checkout para una suscripción humana recurrente
- actions[].type: "machine_pay" — Pro prepago para agentes (30/90 días) o SKUs de recarga vía Stripe MPP; sku predeterminado pro_prepaid_30d a $9.00

Esto es Stripe Machine Payments Protocol, no ChatGPT Instant Checkout / ACP.

Documentación del producto

App: tillpad.cnrcode.com
Docs: tillpad.cnrcode.com/docs
Borrador: tillpad.cnrcode.com/docs/scratchpad
OpenAPI: tillpad.cnrcode.com/openapi.json

El producto Tillpad (Worker, facturación, almacenamiento) es de código cerrado. Este catálogo tiene licencia MIT para que los directorios puedan listar herramientas y fragmentos de instalación.

Listado en directorios

Nombre de registro: com.cnrcode/tillpad (espacio de nombres de dominio vía cnrcode.com).

Asegúrate de que https://cnrcode.com/.well-known/mcp-registry-auth esté desplegado (repositorio cnrcode-site).
Establece el secreto del repositorio de GitHub MCP_PRIVATE_KEY (hex; consulta el script de generación de claves cnrcode-site).
Empuja una etiqueta de versión para que GitHub Actions publique server.json en el Registro MCP oficial:
```
git tag v0.1.1
git push origin v0.1.1
```
Opcionalmente envía https://github.com/CNR-Consulting/tillpad-mcp en mcp.directory/submit.

Glama

Este repositorio incluye un stub de catálogo stdio (src/main.ts) para que Glama pueda construir un contenedor, iniciar el proceso e inspeccionar las 18 definiciones de herramientas. No implementa almacenamiento ni facturación — los clientes aún se conectan al endpoint alojado de arriba.

Listado: glama.ai/mcp/servers/number1101/tillpad-mcp

Después de reclamar vía glama.json, configura la página de administración del Dockerfile:

Campo	Valor
Pasos de compilación	`["npm ci", "npm run build"]`
Argumentos de CMD	`["node", "dist/main.js"]`
Esquema de entorno	predeterminado (vacío — no se necesitan credenciales)
Parámetros de marcador de posición	`{}`

Glama genera su propio Dockerfile desde ese formulario; el repositorio Dockerfile es solo para pruebas de humo locales.

Insignia de puntuación (para awesome-mcp-servers y listas similares):

[![number1101/tillpad-mcp MCP server](https://glama.ai/mcp/servers/number1101/tillpad-mcp/badges/score.svg)](https://glama.ai/mcp/servers/number1101/tillpad-mcp)

Verificación local:

npm ci && npm run build && npm start   # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stub

Paso a paso completo (reclamación, Dockerfile de administración, lanzamiento, PR de awesome-mcp): docs/glama-release.md.

Licencia

MIT — solo catálogo, documentación y stub de esquema.