tillpad-mcp
Tillpad MCP is a remote MCP server for agent-accessible storage, RAG search, usage/budget metering, billing, and run-key lifecycle management.
Check usage, remaining quotas, and preflight whether an operation may hit plan/quota limits.
Get Stripe MPP machine-payment instructions for Pro/prepaid SKUs and start zero-human agent onboarding via email bootstrap token.
Mint run or sub API keys with optional tool, namespace, op-budget, TTL, and wipe-on-expire constraints.
Store, read, delete, and list namespaced key-value strings.
Upload UTF-8 text documents for RAG indexing; list uploaded files and supported file types.
Run semantic search over indexed documents.
Inspect storage inventory across namespaces, keys, files, and vectors.
Finish a run key to wipe its bound namespaces and return a signed wipe receipt.
Contact Tillpad support from an active Pro account.
Note: the README also advertises inbox and scheduled-job tools, but the provided schema does not expose them.
Enables payments for the Tillpad service through Stripe, supporting prepaid agent subscriptions and top-ups via Stripe Machine Payments Protocol plus hosted Checkout URLs for recurring plans.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Tillpad MCP
Everything your AI agents need to do their jobs, with a spending cap they can't go over.
Tillpad gives agents namespaced key-value storage, file upload + semantic search, receive-only email inboxes, budget-aware metering, and run keys that wipe with a signed receipt when the job is done.
Live endpoint: https://tillpad.dev/mcp
The previous endpoint https://tillpad.cnrcode.com/mcp keeps serving the same server, so existing client configs keep working.
This repository is the public catalog and schema stub for directory crawlers. It is not the hosted server. Point MCP clients at the live URL above with a Tillpad API key. Running the TypeScript in this repo does not store or search anything.
Agent guide: see AGENTS.md for discovery URLs, auth, and MCP connect snippets.
Get an API key
Zero-human (agents)
POST https://tillpad.dev/api/agents/bootstrapwith{ "email": "agent@example.com" }→bootstrapToken(no outbound mail).POST https://tillpad.dev/api/billing/machine-paywithAuthorization: Bearer <bootstrapToken>and optional{ "sku": "pro_prepaid_30d" }.Settle Stripe MPP ($9.00 / 30 days) → response includes
secret(tp_…) andplanPeriodEnd.
See scratchpad.txt and llms-full.txt. Legal: Terms.
Human path
Open tillpad.dev and create an account.
Subscribe to Tillpad Pro on Pricing, then mint an API key in the dashboard. Secrets start with
tp_.Use an account key for ongoing access, or a run key when the job should expire and wipe.
Never commit a real key. Use the tp_… placeholder in configs.
Related MCP server: Agent Memory MCP Server
Connect a client
Transport is Streamable HTTP. Send Authorization: Bearer tp_… on every request.
Cursor
Install via Cursor Marketplace (plugin)
This repo includes a Cursor plugin manifest and root mcp.json for one-click install from the Cursor Marketplace.
Tillpad MCP tools cover namespaced KVP, RAG search, receive-only email inboxes, scheduled HTTPS jobs, budget metering, and run-key wipe receipts.
Install the Tillpad plugin from the marketplace (or test locally — see below).
Open Cursor Settings → Customize → Tillpad and set Tillpad API key (
tp_…from bootstrap + machine-pay or the dashboard).Reload the window. MCP tools should appear under the Tillpad server.
The plugin points at https://tillpad.dev/mcp with Authorization: Bearer ${TILLPAD_API_KEY}. Never commit a real key.
Local plugin test (before marketplace submission):
# Copy catalog repo into Cursor local plugins folder
$dest = "$env:USERPROFILE\.cursor\plugins\local\tillpad"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item -Recurse -Force "C:\dev\tillpad\tillpad-mcp\*" $dest
# Then: Cursor Customize → Tillpad → set TILLPAD_API_KEY → Developer: Reload WindowSubmit the public repo at cursor.com/marketplace/publish when ready.
Manual MCP config
User or project MCP config:
{
"mcpServers": {
"tillpad": {
"url": "https://tillpad.dev/mcp",
"headers": {
"Authorization": "Bearer tp_…"
}
}
}
}Claude Desktop / Claude Code
{
"mcpServers": {
"tillpad": {
"command": "npx",
"args": ["mcp-remote", "https://tillpad.dev/mcp", "--header", "Authorization: Bearer tp_…"]
}
}
}Generic remote MCP
{
"url": "https://tillpad.dev/mcp",
"headers": {
"Authorization": "Bearer tp_…"
}
}Discovery manifests on the product host:
Tools
Schemas in src/server.ts match the hosted server.
Tool | What it does |
| Usage for one month ( |
| Preflight 402/429 before a meter spend ( |
| MPP machine-pay instructions ( |
| Zero-human onboarding: bootstrap token from email (no outbound mail) |
| Mint a run or sub key from an account |
| Put, get, delete, or list a namespaced string |
| Put or get memory scope |
| Semantic search over indexed documents or a memory scope |
| Index a named UTF-8 file ( |
| List uploads ( |
| Namespace inventory (scoped to the key when applicable) |
| Wipe namespaces bound to this run key; returns a signed wipe receipt |
| Contact Tillpad support from a Pro account; replies go to the account email |
| Create, list, get, delete, or audit receive-only inboxes |
| List metadata, get one message, download raw MIME, or fetch an attachment |
| Register, list, disable, or inspect |
| List, add, or remove a blocked sender address or domain |
| Create, list, get, disable, or list runs for HTTPS interval jobs |
Typical agent loop
Mint a run key with
create_api_key(or the dashboard): dedicated namespace, TTL, optional op budget.Store working state with
manage_memory/manage_kvand/orindex_document.Retrieve with
manage_memory/manage_kvandsearch_documents.Call
finish_runto wipe run namespaces and keep the signed receipt.
Use estimate_usage before large index jobs. get_usage shows what is left in the period.
Auth and errors
401 — missing or invalid
Authorization: Bearer tp_…402 / 429 — plan or quota. JSON includes
code,status,actions, andbudgetactions[].type: "checkout"— hosted Stripe Checkout URL for a recurring human subscriptionactions[].type: "machine_pay"— agent prepaid Pro (30/90 days) or top-up SKUs via Stripe MPP; default skupro_prepaid_30dat $9.00
This is Stripe Machine Payments Protocol, not ChatGPT Instant Checkout / ACP.
Product docs
App: tillpad.dev
Docs: tillpad.dev/docs
Scratchpad: tillpad.dev/docs/scratchpad
OpenAPI: tillpad.dev/openapi.json
The Tillpad product (Worker, billing, storage) is closed source. This catalog is MIT-licensed so directories can list tools and install snippets.
Directory listing
Registry name: com.cnrcode/tillpad (domain namespace via cnrcode.com).
Ensure
https://cnrcode.com/.well-known/mcp-registry-authis deployed (cnrcode-siterepo).Set GitHub repo secret
MCP_PRIVATE_KEY(hex; seecnrcode-sitekey generation script).Push a version tag so GitHub Actions publishes
server.jsonto the official MCP Registry:git tag v0.2.0 git push origin v0.2.0Optionally submit https://github.com/CNR-Consulting/tillpad-mcp at mcp.directory/submit.
Glama
This repo includes a stdio catalog stub (src/main.ts) so Glama can build a container, start the process, and introspect the 18 tool definitions. It does not implement storage or billing — clients still connect to the hosted endpoint above.
Listing: glama.ai/mcp/servers/number1101/tillpad-mcp
After claiming via glama.json, configure the Dockerfile admin page:
Field | Value |
Build steps |
|
CMD arguments |
|
Env schema | default (empty — no credentials needed) |
Placeholder params |
|
Glama generates its own Dockerfile from that form; the repo Dockerfile is for local smoke tests only.
Score badge (for awesome-mcp-servers and similar lists):
[](https://glama.ai/mcp/servers/number1101/tillpad-mcp)Local verify:
npm ci && npm run build && npm start # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stubFull step-by-step (claim, admin Dockerfile, release, awesome-mcp PR): docs/glama-release.md.
License
MIT — catalog, documentation, and schema stub only.
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