tillpad-mcp
Tillpad MCP
Ограниченное хранилище и поиск для задач агентов.
Tillpad предоставляет агентам хранилище ключ-значение с пространствами имён, загрузку файлов + семантический поиск, учёт расхода с учётом бюджета и run-ключи, которые при завершении задачи стирают данные и возвращают подписанную квитанцию.
Живой endpoint: https://tillpad.cnrcode.com/mcp
Этот репозиторий — публичный каталог и заглушка схемы для краулеров каталогов. Это не размещённый сервер. Направляйте MCP-клиенты на указанный выше живой URL с API-ключом Tillpad. Запуск TypeScript-кода из этого репозитория ничего не хранит и не ищет.
Руководство для агентов: см. AGENTS.md — там URL для обнаружения, аутентификация и фрагменты подключения MCP.
Получить API-ключ
Без участия человека (агенты)
POST https://tillpad.cnrcode.com/api/agents/bootstrapс{ "email": "agent@example.com" }→bootstrapToken(исходящая почта не отправляется).POST https://tillpad.cnrcode.com/api/billing/machine-payсAuthorization: Bearer <bootstrapToken>и опциональным{ "sku": "pro_prepaid_30d" }.Оплатите Stripe MPP ($9.00 / 30 дней) → ответ содержит
secret(tp_…) иplanPeriodEnd.
См. scratchpad.txt и llms-full.txt. Правовая информация: Условия.
Путь для человека
Откройте tillpad.cnrcode.com и создайте аккаунт.
Оформите подписку Tillpad Pro на странице Pricing, затем создайте API-ключ в панели управления. Секреты начинаются с
tp_.Используйте 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 | Что делает |
| Текущее использование за период и квоты |
| Оставшиеся квоты, мягкие пороги и URL для checkout |
| Предварительная проверка 402/429 перед тратами ( |
| Как агенты разблокируют предоплаченный Pro или покупают SKU через Stripe MPP ( |
| Онбординг без участия человека: bootstrap-токен из email (без исходящей почты) |
| Создать run/sub-ключ из account-ключа |
| Сохранить строку в пространстве имён/ключе (ответ включает |
| Прочитать значение из пространства имён |
| Удалить KVP-ключ |
| Список ключей в пространстве имён |
| Загрузить UTF-8 текст для RAG-индексации (prefLights |
| Список загруженных файлов |
| Поддерживаемые расширения загрузки и MIME-типы |
| Семантический поиск по индексированным документам |
| Инвентаризация пространств имён (ограничено ключом, где применимо) |
| Стереть пространства имён, привязанные к этому run-ключу; возвращает подписанную квитанцию о стирании |
| Связаться с поддержкой Tillpad из Pro-аккаунта; ответы приходят на email аккаунта |
Типичный цикл работы агента
Создайте run-ключ в панели управления (отдельное пространство имён, TTL, опциональный бюджет операций).
Сохраняйте рабочее состояние с помощью
kvp_putи/илиfile_upload.Получайте данные через
kvp_get/kvp_listиrag_search.Вызовите
run_finish, чтобы стереть run-пространства имён и сохранить подписанную квитанцию.
Используйте budget_estimate перед большими задачами индексации. budget_get / usage_get показывают, что осталось в периоде.
Аутентификация и ошибки
401 — отсутствует или недействителен
Authorization: Bearer tp_…402 / 429 — тарифный план или квота. JSON включает
code,status,actionsиbudgetactions[].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.cnrcode.com
Документация: tillpad.cnrcode.com/docs
Черновик: tillpad.cnrcode.com/docs/scratchpad
OpenAPI: tillpad.cnrcode.com/openapi.json
Продукт Tillpad (Worker, биллинг, хранилище) имеет закрытый исходный код. Этот каталог распространяется по лицензии MIT, чтобы каталоги могли перечислять инструменты и фрагменты установки.
Листинг в каталогах
Имя в реестре: com.cnrcode/tillpad (доменное пространство имён через cnrcode.com).
Убедитесь, что
https://cnrcode.com/.well-known/mcp-registry-authразвёрнут (репозиторийcnrcode-site).Задайте секрет репозитория GitHub
MCP_PRIVATE_KEY(hex; см. скрипт генерации ключей вcnrcode-site).Запушьте тег версии, чтобы GitHub Actions опубликовал
server.jsonв официальный MCP Registry:
git tag v0.1.1
git push origin v0.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:
Поле | Значение |
Шаги сборки |
|
Аргументы CMD |
|
Схема окружения | по умолчанию (пусто — учетные данные не нужны) |
Параметры-заполнители |
|
Glama генерирует собственный Dockerfile из этой формы; Dockerfile в репозитории предназначен только для локальных смоук-тестов.
Бейдж оценки (для awesome-mcp-servers и подобных списков):
[](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 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