tillpad-mcp
Tillpad MCP
Begrenzter Speicher und Suche für Agent-Jobs.
Tillpad bietet Agents Key-Value-Speicher mit Namespaces, Datei-Upload + semantische Suche, budgetbewusstes Metering und Run-Keys, die bei Jobabschluss die Daten löschen und eine signierte Quittung liefern.
Live-Endpunkt: https://tillpad.cnrcode.com/mcp
Dieses Repository ist der öffentliche Katalog- und Schema-Stub für Verzeichnis-Crawler. Es ist nicht der gehostete Server. Richten Sie MCP-Clients mit einem Tillpad-API-Key auf die obige Live-URL aus. Das Ausführen des TypeScript-Codes in diesem Repository speichert oder durchsucht nichts.
Agent-Guide: siehe AGENTS.md für Discovery-URLs, Authentifizierung und MCP-Verbindungs-Snippets.
API-Key erhalten
Zero-human (Agents)
POST https://tillpad.cnrcode.com/api/agents/bootstrapmit{ "email": "agent@example.com" }→bootstrapToken(keine ausgehende E-Mail).POST https://tillpad.cnrcode.com/api/billing/machine-paymitAuthorization: Bearer <bootstrapToken>und optional{ "sku": "pro_prepaid_30d" }.Stripe MPP begleichen ($9.00 / 30 Tage) → die Antwort enthält
secret(tp_…) undplanPeriodEnd.
Siehe scratchpad.txt und llms-full.txt. Rechtliches: Nutzungsbedingungen.
Weg für Menschen
Öffnen Sie tillpad.cnrcode.com und erstellen Sie ein Konto.
Abonnieren Sie Tillpad Pro unter Preise und erstellen Sie dann im Dashboard einen API-Key. Secrets beginnen mit
tp_.Verwenden Sie einen Account-Key für dauerhaften Zugriff oder einen Run-Key, wenn der Job ablaufen und gelöscht werden soll.
Committen Sie niemals einen echten Key. Verwenden Sie den Platzhalter tp_… in Konfigurationen.
Related MCP server: Agent Memory MCP Server
Einen Client verbinden
Der Transport ist Streamable HTTP. Senden Sie bei jeder Anfrage Authorization: Bearer tp_….
Cursor
MCP-Konfiguration für Benutzer oder Projekt:
{
"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_…"]
}
}
}Generisches Remote-MCP
{
"url": "https://tillpad.cnrcode.com/mcp",
"headers": {
"Authorization": "Bearer tp_…"
}
}Discovery-Manifeste auf dem Produkt-Host:
Tools
Die Schemas in src/server.ts entsprechen dem gehosteten Server.
Tool | Was es tut |
| Aktuelle Periodennutzung und Kontingente |
| Verbleibende Kontingente, weiche Schwellenwerte und eine Checkout-URL |
| Preflight 402/429 vor dem Verbrauch ( |
| Wie Agents vorausbezahltes Pro freischalten oder SKUs über Stripe MPP kaufen ( |
| Zero-Human-Onboarding: Bootstrap-Token aus E-Mail (keine ausgehende E-Mail) |
| Einen Run-/Sub-Key aus einem Account- |
| Speichert eine Zeichenkette unter einem Namespace/Key (Antwort enthält |
| Liest einen Wert aus einem Namespace |
| Löscht einen KVP-Key |
| Listet Keys in einem Namespace auf |
| Hochladen von UTF-8-Text für die RAG-Indizierung (prefLights |
| Listet hochgeladene Dateien auf |
| Unterstützte Upload-Erweiterungen und MIME-Typen |
| Semantische Suche über indizierte Dokumente |
| Namespace-Inventar (falls zutreffend auf den Key beschränkt) |
| Löscht Namespaces, die an diesen Run-Key gebunden sind; gibt eine signierte Löschquittung zurück |
| Kontakt zum Tillpad-Support von einem Pro-Konto; Antworten gehen an die Konto-E-Mail |
Typischer Agent-Ablauf
Erstellen Sie einen Run-Key im Dashboard (dedizierter Namespace, TTL, optionales Op-Budget).
Speichern Sie den Arbeitszustand mit
kvp_putund/oderfile_upload.Rufen Sie Daten mit
kvp_get/kvp_listundrag_searchab.Rufen Sie
run_finishauf, um Run-Namespaces zu löschen und die signierte Quittung aufzubewahren.
Verwenden Sie budget_estimate vor großen Index-Jobs. budget_get / usage_get zeigen, was in der Periode noch übrig ist.
Authentifizierung und Fehler
401 — fehlender oder ungültiger
Authorization: Bearer tp_…402 / 429 — Plan oder Kontingent. Die JSON-Antwort enthält
code,status,actionsundbudgetactions[].type: "checkout"— gehostete Stripe-Checkout-URL für ein wiederkehrendes menschliches Abonnementactions[].type: "machine_pay"— vorausbezahltes Pro für Agents (30/90 Tage) oder Auflade-SKUs über Stripe MPP; Standard-SKUpro_prepaid_30dfür $9.00
Dies ist das Stripe Machine Payments Protocol, nicht ChatGPT Instant Checkout / ACP.
Produktdokumentation
App: tillpad.cnrcode.com
Dokumentation: tillpad.cnrcode.com/docs
Scratchpad: tillpad.cnrcode.com/docs/scratchpad
OpenAPI: tillpad.cnrcode.com/openapi.json
Das Tillpad-Produkt (Worker, Abrechnung, Speicher) ist Closed Source. Dieser Katalog ist MIT-lizenziert, damit Verzeichnisse Tools und Installations-Snippets auflisten können.
Verzeichnisauflistung
Registrierungsname: com.cnrcode/tillpad (Domain-Namespace über cnrcode.com).
Stellen Sie sicher, dass
https://cnrcode.com/.well-known/mcp-registry-authbereitgestellt ist (cnrcode-site-Repository).Legen Sie das GitHub-Repository-Secret
MCP_PRIVATE_KEYfest (hex; siehecnrcode-site-Skript zur Schlüsselerzeugung).Pushen Sie einen Versions-Tag, damit GitHub Actions
server.jsonin der offiziellen MCP-Registry veröffentlicht:git tag v0.1.1 git push origin v0.1.1Reichen Sie optional https://github.com/number1101/tillpad-mcp bei mcp.directory/submit ein.
Glama
Dieses Repository enthält einen Stdio-Katalog-Stub (src/main.ts), damit Glama einen Container bauen, den Prozess starten und die 17 Tool-Definitionen untersuchen kann. Es implementiert weder Speicher noch Abrechnung — Clients verbinden sich weiterhin mit dem obigen gehosteten Endpunkt.
Eintrag: glama.ai/mcp/servers/number1101/tillpad-mcp
Nach dem Beanspruchen über glama.json konfigurieren Sie die Dockerfile-Admin-Seite:
Feld | Wert |
Build-Schritte |
|
CMD-Argumente |
|
Env-Schema | Standard (leer — keine Anmeldedaten erforderlich) |
Platzhalter-Parameter |
|
Glama generiert sein eigenes Dockerfile aus diesem Formular; das Dockerfile im Repository dient nur für lokale Smoke-Tests.
Score-Badge (für awesome-mcp-servers und ähnliche Listen):
[](https://glama.ai/mcp/servers/number1101/tillpad-mcp)Lokale Überprüfung:
npm ci && npm run build && npm start # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stubVollständige Schritt-für-Schritt-Anleitung (Claim, Admin-Dockerfile, Release, awesome-mcp-PR): docs/glama-release.md.
Lizenz
MIT — nur Katalog, Dokumentation und Schema-Stub.
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