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)

1. POST https://tillpad.cnrcode.com/api/agents/bootstrap mit { "email": "agent@example.com" } → bootstrapToken (keine ausgehende E-Mail).

2. POST https://tillpad.cnrcode.com/api/billing/machine-pay mit Authorization: Bearer <bootstrapToken> und optional { "sku": "pro_prepaid_30d" }.

3. Stripe MPP begleichen ($9.00 / 30 Tage) → die Antwort enthält secret (tp_…) und planPeriodEnd.

Siehe scratchpad.txt und llms-full.txt. Rechtliches: Nutzungsbedingungen.

Weg für Menschen

1. Öffnen Sie tillpad.cnrcode.com und erstellen Sie ein Konto.

2. Abonnieren Sie Tillpad Pro unter Preise und erstellen Sie dann im Dashboard einen API-Key. Secrets beginnen mit tp_.

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

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:

• /.well-known/mcp.json

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

• /llms.txt

Tools

Die Schemas in src/server.ts entsprechen dem gehosteten Server.

Typischer Agent-Ablauf

1. Erstellen Sie einen Run-Key im Dashboard (dedizierter Namespace, TTL, optionales Op-Budget).

2. Speichern Sie den Arbeitszustand mit kvp_put und/oder file_upload.

3. Rufen Sie Daten mit kvp_get / kvp_list und rag_search ab.

4. Rufen Sie run_finish auf, 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, actions und budget

  • actions[].type: "checkout" — gehostete Stripe-Checkout-URL für ein wiederkehrendes menschliches Abonnement

  • actions[].type: "machine_pay" — vorausbezahltes Pro für Agents (30/90 Tage) oder Auflade-SKUs über Stripe MPP; Standard-SKU pro_prepaid_30d fü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).

1. Stellen Sie sicher, dass https://cnrcode.com/.well-known/mcp-registry-auth bereitgestellt ist (cnrcode-site-Repository).

2. Legen Sie das GitHub-Repository-Secret MCP_PRIVATE_KEY fest (hex; siehe cnrcode-site-Skript zur Schlüsselerzeugung).

3. Pushen Sie einen Versions-Tag, damit GitHub Actions server.json in der offiziellen MCP-Registry veröffentlicht:

   git tag v0.1.1
   git push origin v0.1.1

4. Reichen 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:

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

[![number1101/tillpad-mcp MCP server](https://glama.ai/mcp/servers/number1101/tillpad-mcp/badges/score.svg)](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-stub

Vollstä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.