Skip to main content
Glama

Tillpad MCP

Everything your AI agents need to do their jobs, with a spending cap they can't go over.

Remote MCP Transport Auth License: MIT Listed on mcpservers.org

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)

  1. POST https://tillpad.dev/api/agents/bootstrap with { "email": "agent@example.com" } → bootstrapToken (no outbound mail).

  2. POST https://tillpad.dev/api/billing/machine-pay with Authorization: Bearer <bootstrapToken> and optional { "sku": "pro_prepaid_30d" }.

  3. Settle Stripe MPP ($9.00 / 30 days) → response includes secret (tp_…) and planPeriodEnd.

See scratchpad.txt and llms-full.txt. Legal: Terms.

Human path

  1. Open tillpad.dev and create an account.

  2. Subscribe to Tillpad Pro on Pricing, then mint an API key in the dashboard. Secrets start with tp_.

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

  1. Install the Tillpad plugin from the marketplace (or test locally — see below).

  2. Open Cursor Settings → Customize → Tillpad and set Tillpad API key (tp_… from bootstrap + machine-pay or the dashboard).

  3. 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 Window

Submit 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

get_usage

Usage for one month (view=summary), paged history (view=periods), or remaining quotas (view=budget)

estimate_usage

Preflight 402/429 before a meter spend (textLength / byteLength for rag_index)

manage_billing

MPP machine-pay instructions (action=machine_pay), Stripe portal URL, or purchase history

bootstrap_agent

Zero-human onboarding: bootstrap token from email (no outbound mail)

create_api_key

Mint a run or sub key from an account tp_ key

manage_kv

Put, get, delete, or list a namespaced string

manage_memory

Put or get memory scope prefs / facts / run

search_documents

Semantic search over indexed documents or a memory scope

index_document

Index a named UTF-8 file (kind=file) or a short note (kind=note)

list_files

List uploads (view=files) or supported types (view=supported_types)

get_storage_summary

Namespace inventory (scoped to the key when applicable)

finish_run

Wipe namespaces bound to this run key; returns a signed wipe receipt

contact_support

Contact Tillpad support from a Pro account; replies go to the account email

manage_inbox

Create, list, get, delete, or audit receive-only inboxes

read_inbox_message

List metadata, get one message, download raw MIME, or fetch an attachment

manage_inbox_webhook

Register, list, disable, or inspect email.received webhook deliveries

manage_inbox_blocklist

List, add, or remove a blocked sender address or domain

manage_schedule

Create, list, get, disable, or list runs for HTTPS interval jobs

Typical agent loop

  1. Mint a run key with create_api_key (or the dashboard): dedicated namespace, TTL, optional op budget.

  2. Store working state with manage_memory / manage_kv and/or index_document.

  3. Retrieve with manage_memory / manage_kv and search_documents.

  4. Call finish_run to 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, and budget

    • actions[].type: "checkout" — hosted Stripe Checkout URL for a recurring human subscription

    • actions[].type: "machine_pay" — agent prepaid Pro (30/90 days) or top-up SKUs via Stripe MPP; default sku pro_prepaid_30d at $9.00

This is Stripe Machine Payments Protocol, not ChatGPT Instant Checkout / ACP.

Product docs

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

  1. Ensure https://cnrcode.com/.well-known/mcp-registry-auth is deployed (cnrcode-site repo).

  2. Set GitHub repo secret MCP_PRIVATE_KEY (hex; see cnrcode-site key generation script).

  3. Push a version tag so GitHub Actions publishes server.json to the official MCP Registry:

    git tag v0.2.0
    git push origin v0.2.0
  4. Optionally 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

["npm ci", "npm run build"]

CMD arguments

["node", "dist/main.js"]

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

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

Full 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 tools
agent_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_listCInspect

List keys in a KVP namespace

Inputs: namespace (required), limit, cursor.

kvp_putBInspect

Store a string value under a namespace/key. Response includes budget remaining.

Inputs: key (required), value (required), namespace (required), expirationTtl.

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

usage_getAInspect

Get current period usage and quotas for the authenticated account

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency2/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      13
      1
      MIT