tillpad-mcp
Tillpad MCP
Almacenamiento y búsqueda acotados para trabajos de agentes.
Tillpad ofrece a los agentes almacenamiento de 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 borran 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 del agente: consulte AGENTS.md para ver URLs de descubrimiento, autenticación y fragmentos de conexión MCP.
Obtenga una clave API
Sin humanos (agentes)
POST https://tillpad.cnrcode.com/api/agents/bootstrapcon{ "email": "agent@example.com" }→bootstrapToken(sin correo saliente).POST https://tillpad.cnrcode.com/api/billing/machine-payconAuthorization: Bearer <bootstrapToken>y opcional{ "sku": "pro_prepaid_30d" }.Liquidar Stripe MPP ($9.00 / 30 días) → la respuesta incluye
secret(tp_…) yplanPeriodEnd.
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 borrarse.
Nunca confirme una clave real. Use el marcador de posición tp_… en las configuraciones.
Related MCP server: Agent Memory MCP Server
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.
Tool | Qué hace |
| Uso y cuotas del período actual |
| Cuotas restantes, umbrales suaves y una URL de pago |
| Comprobación previa de 402/429 antes de gastar ( |
| Cómo los agentes desbloquean Pro prepago o compran SKUs mediante Stripe MPP ( |
| Incorporación sin humanos: token de arranque desde el correo electrónico (sin correo saliente) |
| Generar una clave de ejecución/subclave a partir de una clave de cuenta |
| Almacenar una cadena bajo un espacio de nombres/clave (la respuesta incluye |
| Leer un valor con espacio de nombres |
| Eliminar una clave KVP |
| Listar claves en un espacio de nombres |
| Subir texto UTF-8 para indexación RAG (prefLights |
| Listar archivos subidos |
| Extensiones de subida admitidas y tipos MIME |
| Búsqueda semántica sobre documentos indexados |
| Inventario de espacios de nombres (limitado a la clave cuando corresponda) |
| Borrar espacios de nombres vinculados a esta clave de ejecución; devuelve un recibo de borrado firmado |
| Contactar con el soporte de Tillpad desde una cuenta Pro; las respuestas van al correo de la cuenta |
Bucle típico del 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_puty/ofile_upload.Recupere con
kvp_get/kvp_listyrag_search.Llame a
run_finishpara borrar 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 no es válida la
Authorization: Bearer tp_…402 / 429 — plan o cuota. El JSON incluye
code,status,actionsybudgetactions[].type: "checkout"— URL de Stripe Checkout alojada para una suscripción humana recurrenteactions[].type: "machine_pay"— Pro prepago para agentes (30/90 días) o SKUs de recarga mediante Stripe MPP; sku predeterminadopro_prepaid_30da $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 de directorio
Nombre de registro: com.cnrcode/tillpad (espacio de nombres de dominio a través de cnrcode.com).
Asegúrese de que
https://cnrcode.com/.well-known/mcp-registry-authesté implementado (repositoriocnrcode-site).Establezca el secreto del repositorio de GitHub
MCP_PRIVATE_KEY(hex; consulte el script de generación de claves decnrcode-site).Empuje una etiqueta de versión para que GitHub Actions publique
server.jsonen el Registro MCP oficial:
git tag v0.1.1
git push origin v0.1.1Opcionalmente, 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 a través de glama.json, configure la página de administración del Dockerfile:
Campo | Valor |
Pasos de compilación |
|
Argumentos de CMD |
|
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 Dockerfile del repositorio es solo para pruebas locales de humo.
Insignia de puntuación (para awesome-mcp-servers y listas similares):
[](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-stubPaso 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.
Available Tools
17 toolsagent_bootstrapAInspect
Start zero-human onboarding: create bootstrap token from email (no outbound mail). Next POST /api/billing/machine-pay with Bearer bootstrapToken.
Inputs: email (required), label.
billing_machine_payAInspect
Describe how to unlock Pro or purchase agent SKUs via Stripe MPP. Optional sku (default pro_prepaid_30d). Returns POST URL and amount; agent must call HTTP with MPP Payment credential.
Inputs: sku.
budget_estimateAInspect
Estimate whether an operation would hit 402/429 before spending. For rag_index you can pass textLength/byteLength instead of amount.
Inputs: kind (required), amount, byteLength, textLength.
budget_getBInspect
Get remaining quotas, soft thresholds, and checkout URL for topping up
Inputs: no named parameters.
files_listCInspect
List uploaded files (optionally filter by namespace)
Inputs: namespace.
files_typesAInspect
List supported RAG upload file types (extensions, MIME types, extract notes)
Inputs: no named parameters.
file_uploadCInspect
Upload a UTF-8 text document for RAG indexing into a namespace. PrefLights rag_index capacity.
Inputs: text (required), filename (required), namespace (required), contentType.
inspect_storageBInspect
Summarize namespaces, key counts, file/vector inventory
Inputs: no named parameters.
keys_createAInspect
Mint a run or sub API key from an account key (REST POST /api/keys). Requires account tp_ key.
Inputs: kind (required), name, tools, opBudget, +3 more.
kvp_deleteCInspect
Delete a KVP key
Inputs: key (required), namespace (required).
kvp_getCInspect
Read a value from namespaced KVP storage
Inputs: key (required), namespace (required).
kvp_putBInspect
Store a string value under a namespace/key. Response includes budget remaining.
Inputs: key (required), value (required), namespace (required), expirationTtl.
rag_searchCInspect
Semantic search over indexed documents
Inputs: query (required), topK, namespace.
run_finishAInspect
Wipe all namespaces bound to this run key and return a signed wipe receipt. Only valid for run keys.
Inputs: no named parameters.
support_contactAInspect
Contact Tillpad support from a Pro account. Delivers your subject and message to the Tillpad team; replies go to the account email. Requires an active Pro subscription.
Inputs: message (required), subject (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct operation within its area—billing, keys, KVP, files/RAG, support—and the descriptions clarify boundaries. usage_get and budget_get both report quota state but with different focuses, and inspect_storage aggregates rather than duplicating the CRUD tools. Overall, misselection risk is low.
Names mix verb-first styles (usage_get, file_upload, inspect_storage) with noun-first styles (keys_create, kvp_put, run_finish) and compound nouns like billing_machine_pay. There is no consistent verb_noun convention, though prefixes like kvp_ and files_ provide some structure.
17 tools is at the high end for a single MCP server and spans several unrelated domains: billing, key management, key-value storage, RAG files, and support. For a multi-purpose platform API the count is defensible, but it is heavier than a focused, well-scoped server should be.
KVP storage has full CRUD and RAG covers upload, listing, and semantic search, but file deletion is missing and key management only supports creation, not listing or revocation. Billing covers usage and budgets but not detailed subscription state or payment history. These gaps are workable but notable for a platform toolkit.
Maintenance
Related MCP Connectors
Persistent cloud memory for AI agents. Store and search key-value memories across sessions.
Persistent memory for AI agents. Search and store durable facts, preferences and decisions.
Persistent memory for AI agents: save, search and connect context across tools and sessions.
Governed local-first memory and continuity for AI agents — signed receipts, optional hosted lane.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with persistent, searchable memory that survives across conversations using semantic search, temporal versioning, and smart organization. Enables long-term context retention and cross-session continuity for AI assistants.14-
- AlicenseAqualityDmaintenanceProvides persistent key-value storage with full-text search, tags, and namespaces for AI agents to maintain context across sessions.760 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to automatically capture durable knowledge and retrieve only relevant, token-bounded context from a secure local-first long-term memory, with support for progressive disclosure, snapshots, health diagnostics, and background tasks.Apache 2.0
- AlicenseBqualityBmaintenanceEnables agents and apps to verify end-user identity through company API keys, human login links with multi-channel notifications, OIDC client registration, and budget-aware billing.131MIT