Servidor MCP de Tillpad | Awesome MCP Servers

Tillpad MCP

Almacenamiento acotado y búsqueda para trabajos de agentes.

Tillpad ofrece a los agentes almacenamiento clave-valor con espacios de nombres, carga de archivos + búsqueda semántica, medición 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. Apunte los clientes MCP a la URL en vivo anterior con una clave API de Tillpad. Ejecutar el TypeScript en este repositorio no almacena ni busca nada.

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

Obtener una clave API

Sin intervención humana (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.
Liquidar Stripe MPP ($9.00 / 30 días) → la respuesta incluye secret (tp_…) y planPeriodEnd.

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

Ruta humana

Abra tillpad.cnrcode.com y cree una cuenta.
Suscríbase a Tillpad Pro en Precios, luego genere una clave API en el panel. Los secretos comienzan con tp_.
Use una clave de cuenta para acceso continuo, o una clave de ejecución cuando el trabajo deba expirar y eliminarse.

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

Conectar un cliente

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

Cursor

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
`usage_get`	Uso y cuotas del período actual
`budget_get`	Cuotas restantes, umbrales suaves y una URL de pago
`budget_estimate`	Verificación previa 402/429 antes de gastar (`textLength` / `byteLength` para `rag_index`)
`billing_machine_pay`	Cómo los agentes desbloquean Pro prepago o compran SKUs mediante Stripe MPP (`sku` opcional)
`agent_bootstrap`	Incorporación sin intervención humana: token de arranque desde correo electrónico (sin correo saliente)
`keys_create`	Generar una clave de ejecución/sub desde una clave de cuenta `tp_`
`kvp_put`	Almacenar una cadena bajo un espacio de nombres/clave (la respuesta incluye `budget`)
`kvp_get`	Leer un valor con espacio de nombres
`kvp_delete`	Eliminar una clave KVP
`kvp_list`	Listar claves en un espacio de nombres
`file_upload`	Cargar texto UTF-8 para indexación RAG (prefLights `rag_index`)
`files_list`	Listar archivos cargados
`files_types`	Extensiones de carga admitidas y tipos MIME
`rag_search`	Búsqueda semántica sobre documentos indexados
`inspect_storage`	Inventario de espacios de nombres (limitado a la clave cuando corresponda)
`run_finish`	Eliminar espacios de nombres vinculados a esta clave de ejecución; devuelve un recibo de eliminación firmado
`support_contact`	Contactar al soporte de Tillpad desde una cuenta Pro; las respuestas van al correo de la cuenta

Bucle típico de agente

Genere una clave de ejecución en el panel (espacio de nombres dedicado, TTL, presupuesto operativo opcional).
Almacene el estado de trabajo con kvp_put y/o file_upload.
Recupere con kvp_get / kvp_list y rag_search.
Llame a run_finish para eliminar los espacios de nombres de ejecución y conservar el recibo firmado.

Use budget_estimate antes de trabajos de indexación grandes. budget_get / usage_get muestran 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 de Stripe Checkout alojada para una suscripción humana recurrente
- actions[].type: "machine_pay" — Pro prepago para agentes (30/90 días) o SKUs de recarga mediante 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

Aplicación: tillpad.cnrcode.com
Documentación: tillpad.cnrcode.com/docs
Bloc de notas: 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 mediante cnrcode.com).

Asegúrese de que https://cnrcode.com/.well-known/mcp-registry-auth esté desplegado (repositorio cnrcode-site).
Establezca el secreto del repositorio de GitHub MCP_PRIVATE_KEY (hex; consulte el script de generación de claves cnrcode-site).
Envíe una etiqueta de versión para que GitHub Actions publique server.json en el Registro oficial de MCP:
```
git tag v0.1.1
git push origin v0.1.1
```
Opcionalmente, envíe https://github.com/number1101/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 17 definiciones de herramientas. No implementa almacenamiento ni facturación — los clientes aún se conectan al endpoint alojado anterior.

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

Después de reclamar mediante glama.json, configure 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 a partir de ese formulario; el repositorio Dockerfile es solo para pruebas locales de humo.

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

Guía completa paso a paso (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.