Skip to main content
Glama

Tillpad MCP

Ограниченное хранилище и поиск для задач агентов.

Remote MCP Transport Auth License: MIT

Tillpad предоставляет агентам хранилище ключ-значение с пространствами имён, загрузку файлов + семантический поиск, учёт расхода с учётом бюджета и run-ключи, которые при завершении задачи стирают данные и возвращают подписанную квитанцию.

Живой endpoint: https://tillpad.cnrcode.com/mcp

Этот репозиторий — публичный каталог и заглушка схемы для краулеров каталогов. Это не размещённый сервер. Направляйте MCP-клиенты на указанный выше живой URL с API-ключом Tillpad. Запуск TypeScript-кода из этого репозитория ничего не хранит и не ищет.

Руководство для агентов: см. AGENTS.md — там URL для обнаружения, аутентификация и фрагменты подключения MCP.

Получить API-ключ

Без участия человека (агенты)

  1. POST https://tillpad.cnrcode.com/api/agents/bootstrap с { "email": "agent@example.com" } → bootstrapToken (исходящая почта не отправляется).

  2. POST https://tillpad.cnrcode.com/api/billing/machine-pay с Authorization: Bearer <bootstrapToken> и опциональным { "sku": "pro_prepaid_30d" }.

  3. Оплатите Stripe MPP ($9.00 / 30 дней) → ответ содержит secret (tp_…) и planPeriodEnd.

См. scratchpad.txt и llms-full.txt. Правовая информация: Условия.

Путь для человека

  1. Откройте tillpad.cnrcode.com и создайте аккаунт.

  2. Оформите подписку Tillpad Pro на странице Pricing, затем создайте API-ключ в панели управления. Секреты начинаются с tp_.

  3. Используйте account-ключ для постоянного доступа или run-ключ, если задача должна истечь и стереть данные.

Никогда не коммитьте настоящий ключ. Используйте заполнитель tp_… в конфигурациях.

Related MCP server: Agent Memory MCP Server

Подключение клиента

Транспорт — Streamable HTTP. Отправляйте Authorization: Bearer tp_… в каждом запросе.

Cursor

Пользовательская или проектная MCP-конфигурация:

{
  "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

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

Манифесты обнаружения на хосте продукта:

Инструменты

Схемы в src/server.ts соответствуют размещённому серверу.

Tool

Что делает

usage_get

Текущее использование за период и квоты

budget_get

Оставшиеся квоты, мягкие пороги и URL для checkout

budget_estimate

Предварительная проверка 402/429 перед тратами (textLength / byteLength для rag_index)

billing_machine_pay

Как агенты разблокируют предоплаченный Pro или покупают SKU через Stripe MPP (sku опционально)

agent_bootstrap

Онбординг без участия человека: bootstrap-токен из email (без исходящей почты)

keys_create

Создать run/sub-ключ из account-ключа tp_

kvp_put

Сохранить строку в пространстве имён/ключе (ответ включает budget)

kvp_get

Прочитать значение из пространства имён

kvp_delete

Удалить KVP-ключ

kvp_list

Список ключей в пространстве имён

file_upload

Загрузить UTF-8 текст для RAG-индексации (prefLights rag_index)

files_list

Список загруженных файлов

files_types

Поддерживаемые расширения загрузки и MIME-типы

rag_search

Семантический поиск по индексированным документам

inspect_storage

Инвентаризация пространств имён (ограничено ключом, где применимо)

run_finish

Стереть пространства имён, привязанные к этому run-ключу; возвращает подписанную квитанцию о стирании

support_contact

Связаться с поддержкой Tillpad из Pro-аккаунта; ответы приходят на email аккаунта

Типичный цикл работы агента

  1. Создайте run-ключ в панели управления (отдельное пространство имён, TTL, опциональный бюджет операций).

  2. Сохраняйте рабочее состояние с помощью kvp_put и/или file_upload.

  3. Получайте данные через kvp_get / kvp_list и rag_search.

  4. Вызовите run_finish, чтобы стереть run-пространства имён и сохранить подписанную квитанцию.

Используйте budget_estimate перед большими задачами индексации. budget_get / usage_get показывают, что осталось в периоде.

Аутентификация и ошибки

  • 401 — отсутствует или недействителен Authorization: Bearer tp_…

  • 402 / 429 — тарифный план или квота. JSON включает code, status, actions и budget

    • actions[].type: "checkout" — размещённый URL Stripe Checkout для регулярной подписки человека

    • actions[].type: "machine_pay" — предоплаченный Pro для агентов (30/90 дней) или SKU для пополнения через Stripe MPP; SKU по умолчанию pro_prepaid_30d за $9.00

Это Stripe Machine Payments Protocol, а не ChatGPT Instant Checkout / ACP.

Документация продукта

Продукт Tillpad (Worker, биллинг, хранилище) имеет закрытый исходный код. Этот каталог распространяется по лицензии MIT, чтобы каталоги могли перечислять инструменты и фрагменты установки.

Листинг в каталогах

Имя в реестре: com.cnrcode/tillpad (доменное пространство имён через cnrcode.com).

  1. Убедитесь, что https://cnrcode.com/.well-known/mcp-registry-auth развёрнут (репозиторий cnrcode-site).

  2. Задайте секрет репозитория GitHub MCP_PRIVATE_KEY (hex; см. скрипт генерации ключей в cnrcode-site).

  3. Запушьте тег версии, чтобы GitHub Actions опубликовал server.json в официальный MCP Registry:

git tag v0.1.1
git push origin v0.1.1
  1. По желанию отправьте https://github.com/number1101/tillpad-mcp на mcp.directory/submit.

Glama

Этот репозиторий включает stdio-заглушку каталога (src/main.ts), чтобы Glama мог собрать контейнер, запустить процесс и проанализировать 17 определений инструментов. Он не реализует хранилище или биллинг — клиенты по-прежнему подключаются к указанному выше размещённому endpoint.

Листинг: glama.ai/mcp/servers/number1101/tillpad-mcp

После подтверждения через glama.json настройте страницу администратора Dockerfile:

Поле

Значение

Шаги сборки

["npm ci", "npm run build"]

Аргументы CMD

["node", "dist/main.js"]

Схема окружения

по умолчанию (пусто — учетные данные не нужны)

Параметры-заполнители

{}

Glama генерирует собственный Dockerfile из этой формы; Dockerfile в репозитории предназначен только для локальных смоук-тестов.

Бейдж оценки (для awesome-mcp-servers и подобных списков):

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

Локальная проверка:

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

Полная пошаговая инструкция (подтверждение, админ-Dockerfile, релиз, PR в awesome-mcp): docs/glama-release.md.

Лицензия

MIT — только каталог, документация и заглушка схемы.

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