Skip to main content
Glama

Tillpad MCP

Almacenamiento y búsqueda acotados para trabajos de agentes.

Remote MCP Transport Auth License: MIT

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)

  1. POST https://tillpad.cnrcode.com/api/agents/bootstrap con { "email": "agent@example.com" } → bootstrapToken (sin correo saliente).

  2. POST https://tillpad.cnrcode.com/api/billing/machine-pay con Authorization: Bearer <bootstrapToken> y opcional { "sku": "pro_prepaid_30d" }.

  3. 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

  1. Abra tillpad.cnrcode.com y cree una cuenta.

  2. Suscríbase a Tillpad Pro en Precios, luego genere una clave API en el panel. Los secretos comienzan con tp_.

  3. 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

usage_get

Uso y cuotas del período actual

budget_get

Cuotas restantes, umbrales suaves y una URL de pago

budget_estimate

Comprobación previa de 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 humanos: token de arranque desde el correo electrónico (sin correo saliente)

keys_create

Generar una clave de ejecución/subclave a partir de 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

Subir texto UTF-8 para indexación RAG (prefLights rag_index)

files_list

Listar archivos subidos

files_types

Extensiones de subida 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

Borrar espacios de nombres vinculados a esta clave de ejecución; devuelve un recibo de borrado firmado

support_contact

Contactar con el soporte de Tillpad desde una cuenta Pro; las respuestas van al correo de la cuenta

Bucle típico del agente

  1. Genere una clave de ejecución en el panel (espacio de nombres dedicado, TTL, presupuesto operativo opcional).

  2. Almacene el estado de trabajo con kvp_put y/o file_upload.

  3. Recupere con kvp_get / kvp_list y rag_search.

  4. Llame a run_finish para 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, 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

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).

  1. Asegúrese de que https://cnrcode.com/.well-known/mcp-registry-auth esté implementado (repositorio cnrcode-site).

  2. Establezca el secreto del repositorio de GitHub MCP_PRIVATE_KEY (hex; consulte el script de generación de claves de cnrcode-site).

  3. Empuje 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
  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 a través de 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 Dockerfile del repositorio 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

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.

Available Tools

17 tools
agent_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_listCInspect

List keys in a KVP namespace

Inputs: namespace (required), limit, cursor.

kvp_putBInspect

Store a string value under a namespace/key. Response includes budget remaining.

Inputs: key (required), value (required), namespace (required), expirationTtl.

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).

usage_getAInspect

Get current period usage and quotas for the authenticated account

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency2/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      13
      1
      MIT