tillpad-mcp
Tillpad MCP
에이전트 작업을 위한 제한된 저장소 및 검색.
Tillpad는 에이전트에게 네임스페이스 기반 키-값 저장소, 파일 업로드 + 의미론적 검색, 예산 인식 사용량 측정, 그리고 작업이 완료되면 서명된 영수증과 함께 삭제되는 run 키를 제공합니다.
라이브 엔드포인트: https://tillpad.cnrcode.com/mcp
이 저장소는 디렉터리 크롤러를 위한 공개 카탈로그 및 스키마 스텁입니다. 호스팅 서버가 아닙니다. Tillpad API 키를 사용하여 MCP 클라이언트를 위의 라이브 URL에 연결하세요. 이 저장소의 TypeScript를 실행해도 아무것도 저장하거나 검색하지 않습니다.
에이전트 가이드: 검색 URL, 인증 및 MCP 연결 스니펫은 AGENTS.md를 참조하세요.
API 키 받기
제로 휴먼 (에이전트)
POST https://tillpad.cnrcode.com/api/agents/bootstrap를{ "email": "agent@example.com" }과 함께 호출 →bootstrapToken(발신 메일 없음).Authorization: Bearer <bootstrapToken>및 선택적{ "sku": "pro_prepaid_30d" }와 함께POST https://tillpad.cnrcode.com/api/billing/machine-pay호출.Stripe MPP 결제 완료 ($9.00 / 30일) → 응답에
secret(tp_…) 및planPeriodEnd포함.
scratchpad.txt 및 llms-full.txt를 참조하세요. 법적 고지: 이용약관.
휴먼 경로
tillpad.cnrcode.com을 열고 계정을 만드세요.
요금제에서 Tillpad Pro를 구독한 다음 대시보드에서 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 |
| 지출 전 402/429 사전 확인 ( |
| 에이전트가 Stripe MPP를 통해 선불 Pro를 잠금 해제하거나 SKU를 구매하는 방법 ( |
| 제로 휴먼 온보딩: 이메일에서 부트스트랩 토큰 생성 (발신 메일 없음) |
| 계정 |
| 네임스페이스/키 아래에 문자열 저장 (응답에 |
| 네임스페이스 값 읽기 |
| KVP 키 삭제 |
| 네임스페이스의 키 나열 |
| RAG 인덱싱을 위한 UTF-8 텍스트 업로드 (prefLights |
| 업로드된 파일 나열 |
| 지원되는 업로드 확장자 및 MIME 유형 |
| 인덱싱된 문서에 대한 의미론적 검색 |
| 네임스페이스 인벤토리 (해당하는 경우 키로 범위 지정) |
| 이 run 키에 바인딩된 네임스페이스 삭제; 서명된 삭제 영수증 반환 |
| Pro 계정에서 Tillpad 지원팀에 문의; 답변은 계정 이메일로 전송 |
일반적인 에이전트 루프
대시보드에서 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,budget포함actions[].type: "checkout"— 정기 휴먼 구독을 위한 호스팅 Stripe Checkout URLactions[].type: "machine_pay"— 에이전트 선불 Pro (30/90일) 또는 Stripe MPP를 통한 충전 SKU; 기본 skupro_prepaid_30d($9.00)
이는 Stripe Machine Payments Protocol이며, ChatGPT Instant Checkout / ACP가 아닙니다.
제품 문서
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 레지스트리에 게시하도록 하세요:
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개의 도구 정의를 검사할 수 있습니다. 이 스텁은 스토리지나 결제를 구현하지 않습니다. 클라이언트는 여전히 위의 호스팅 엔드포인트에 연결합니다.
등록: 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, 릴리스, awesome-mcp PR): 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