Tillpad MCP

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

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: ContextKeep

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

Транспорт — 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_…"
  }
}

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

• /.well-known/mcp.json

• /.well-known/mcp/server.json

• /llms.txt

Инструменты

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

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

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

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

4. По желанию отправьте 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:

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 — только каталог, документация и заглушка схемы.