Tillpad

Armazenamento limitado e busca para trabalhos de agentes

Documentação

Tillpad MCP

Armazenamento limitado e busca para trabalhos de agentes.

O Tillpad oferece aos agentes armazenamento de chave-valor com namespace, upload de arquivos + busca semântica, caixas de entrada de e-mail somente recebimento, medição com consciência de orçamento e chaves de execução que apagam com um recibo assinado quando o trabalho é concluído.

Endpoint ao vivo: https://tillpad.cnrcode.com/mcp

Este repositório é o catálogo público e stub de esquema para rastreadores de diretório. Não é o servidor hospedado. Aponte clientes MCP para a URL ao vivo acima com uma chave de API Tillpad. Executar o TypeScript neste repositório não armazena nem busca nada.

Guia do agente: veja AGENTS.md para URLs de descoberta, autenticação e trechos de conexão MCP.

Obtenha uma chave de API

Caminho zero-humano (agentes)

POST https://tillpad.cnrcode.com/api/agents/bootstrap com { "email": "agent@example.com" } → bootstrapToken (sem e-mail de saída).
POST https://tillpad.cnrcode.com/api/billing/machine-pay com Authorization: Bearer <bootstrapToken> e { "sku": "pro_prepaid_30d" } opcional.
Liquide o Stripe MPP ($9,00 / 30 dias) → a resposta inclui secret (tp_…) e planPeriodEnd.

Veja scratchpad.txt e llms-full.txt. Legal: Termos.

Caminho humano

Abra tillpad.cnrcode.com e crie uma conta.
Assine o Tillpad Pro em Preços e depois crie uma chave de API no painel. Os segredos começam com tp_.
Use uma chave de conta para acesso contínuo, ou uma chave de execução quando o trabalho deve expirar e apagar.

Nunca envie uma chave real. Use o espaço reservado tp_… nas configurações.

Conecte um cliente

O transporte é Streamable HTTP. Envie Authorization: Bearer tp_… em cada solicitação.

Cursor

Instalação via Cursor Marketplace (plugin)

Este repositório inclui um manifesto de plugin Cursor e mcp.json raiz para instalação com um clique no Cursor Marketplace.

As ferramentas MCP do Tillpad cobrem KVP com namespace, busca RAG, caixas de entrada de e-mail somente recebimento, trabalhos HTTPS agendados, medição de orçamento e recibos de apagamento de chave de execução.

Instale o plugin Tillpad do marketplace (ou teste localmente — veja abaixo).
Abra Cursor Settings → Customize → Tillpad e defina a chave de API Tillpad (tp_… do bootstrap + pagamento por máquina ou do painel).
Recarregue a janela. As ferramentas MCP devem aparecer sob o servidor Tillpad.

O plugin aponta para https://tillpad.cnrcode.com/mcp com Authorization: Bearer ${TILLPAD_API_KEY}. Nunca envie uma chave real.

Teste local do plugin (antes do envio ao marketplace):

# 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

Envie o repositório público em cursor.com/marketplace/publish quando estiver pronto.

Configuração manual do MCP

Configuração MCP do usuário ou do projeto:

{
  "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 remoto genérico

{
  "url": "https://tillpad.cnrcode.com/mcp",
  "headers": {
    "Authorization": "Bearer tp_…"
  }
}

Manifestos de descoberta no host do produto:

Ferramentas

Os esquemas em src/server.ts correspondem ao servidor hospedado.

Ferramenta	O que faz
`get_usage`	Uso de um mês (`view=summary`), histórico paginado (`view=periods`) ou cotas restantes (`view=budget`)
`estimate_usage`	Pré-verificação 402/429 antes de um gasto medido (`textLength` / `byteLength` para `rag_index`)
`manage_billing`	Instruções de pagamento por máquina MPP (`action=machine_pay`), URL do portal Stripe ou histórico de compras
`bootstrap_agent`	Integração zero-humano: token de bootstrap do e-mail (sem e-mail de saída)
`create_api_key`	Crie uma chave de execução ou subchave a partir de uma chave de conta `tp_`
`manage_kv`	Colocar, obter, excluir ou listar uma string com namespace
`manage_memory`	Colocar ou obter escopo de memória `prefs` / `facts` / `run`
`search_documents`	Busca semântica sobre documentos indexados ou um escopo de memória
`index_document`	Indexar um arquivo UTF-8 nomeado (`kind=file`) ou uma nota curta (`kind=note`)
`list_files`	Listar uploads (`view=files`) ou tipos suportados (`view=supported_types`)
`get_storage_summary`	Inventário de namespaces (escopo para a chave quando aplicável)
`finish_run`	Apagar namespaces vinculados a esta chave de execução; retorna um recibo de apagamento assinado
`contact_support`	Contatar o suporte Tillpad de uma conta Pro; as respostas vão para o e-mail da conta
`manage_inbox`	Criar, listar, obter, excluir ou auditar caixas de entrada somente recebimento
`read_inbox_message`	Listar metadados, obter uma mensagem, baixar MIME bruto ou buscar um anexo
`manage_inbox_webhook`	Registrar, listar, desativar ou inspecionar entregas de webhook `email.received`
`manage_inbox_blocklist`	Listar, adicionar ou remover um endereço ou domínio de remetente bloqueado
`manage_schedule`	Criar, listar, obter, desativar ou listar execuções para trabalhos de intervalo HTTPS

Loop típico de agente

Crie uma chave de execução com create_api_key (ou o painel): namespace dedicado, TTL, orçamento de operações opcional.
Armazene o estado de trabalho com manage_memory / manage_kv e/ou index_document.
Recupere com manage_memory / manage_kv e search_documents.
Chame finish_run para apagar namespaces de execução e manter o recibo assinado.

Use estimate_usage antes de grandes trabalhos de indexação. get_usage mostra o que resta no período.

Autenticação e erros

401 — chave Authorization: Bearer tp_… ausente ou inválida
402 / 429 — plano ou cota. O JSON inclui code, status, actions e budget
- actions[].type: "checkout" — URL hospedada do Stripe Checkout para uma assinatura humana recorrente
- actions[].type: "machine_pay" — Pro pré-pago para agente (30/90 dias) ou SKUs de recarga via Stripe MPP; sku padrão pro_prepaid_30d a $9,00

Isto é o Protocolo de Pagamentos por Máquina Stripe, não o ChatGPT Instant Checkout / ACP.

Documentação do produto

Aplicativo: tillpad.cnrcode.com
Documentação: tillpad.cnrcode.com/docs
Rascunho: tillpad.cnrcode.com/docs/scratchpad
OpenAPI: tillpad.cnrcode.com/openapi.json

O produto Tillpad (Worker, cobrança, armazenamento) é de código fechado. Este catálogo é licenciado sob MIT para que diretórios possam listar ferramentas e trechos de instalação.

Listagem de diretório

Nome do registro: com.cnrcode/tillpad (namespace de domínio via cnrcode.com).

Garanta que https://cnrcode.com/.well-known/mcp-registry-auth esteja implantado (repositório cnrcode-site).
Defina o segredo do repositório GitHub MCP_PRIVATE_KEY (hex; veja o script de geração de chave cnrcode-site).
Envie uma tag de versão para que GitHub Actions publique server.json no Registro MCP oficial:
```
git tag v0.1.1
git push origin v0.1.1
```
Opcionalmente, envie https://github.com/CNR-Consulting/tillpad-mcp em mcp.directory/submit.

Glama

Este repositório inclui um stub de catálogo stdio (src/main.ts) para que o Glama possa construir um contêiner, iniciar o processo e inspecionar as 18 definições de ferramentas. Ele não implementa armazenamento ou cobrança — os clientes ainda se conectam ao endpoint hospedado acima.

Listagem: glama.ai/mcp/servers/number1101/tillpad-mcp

Após reivindicar via glama.json, configure a página de administração do Dockerfile:

Campo	Valor
Etapas de build	`["npm ci", "npm run build"]`
Argumentos CMD	`["node", "dist/main.js"]`
Esquema de env	padrão (vazio — nenhuma credencial necessária)
Parâmetros de espaço reservado	`{}`

O Glama gera seu próprio Dockerfile a partir desse formulário; o repositório Dockerfile é apenas para testes de fumaça locais.

Distintivo de pontuação (para awesome-mcp-servers e listas semelhantes):

[![number1101/tillpad-mcp MCP server](https://glama.ai/mcp/servers/number1101/tillpad-mcp/badges/score.svg)](https://glama.ai/mcp/servers/number1101/tillpad-mcp)

Verificação local:

npm ci && npm run build && npm start   # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stub

Passo a passo completo (reivindicação, Dockerfile de administração, lançamento, PR awesome-mcp): docs/glama-release.md.

Licença

MIT — apenas catálogo, documentação e stub de esquema.