Servidor MCP Tillpad | Awesome MCP Servers

Tillpad MCP

Armazenamento limitado e busca para trabalhos de agentes.

O Tillpad oferece aos agentes armazenamento de chave-valor com namespaces, upload de arquivos + busca semântica, medição com consciência de orçamento e chaves de execução que são apagadas 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órios. Não é o servidor hospedado. Aponte clientes MCP para a URL ao vivo acima com uma chave de API do Tillpad. Executar o TypeScript neste repositório não armazena nem busca nada.

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

Obtenha uma chave de API

Sem intervenção humana (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.

Consulte 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 gere 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 ser apagado.

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

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
`usage_get`	Uso e cotas do período atual
`budget_get`	Cotas restantes, limites suaves e uma URL de checkout
`budget_estimate`	Pré-verificação 402/429 antes de gastar (`textLength` / `byteLength` para `rag_index`)
`billing_machine_pay`	Como agentes desbloqueiam Pro pré-pago ou compram SKUs via Stripe MPP (`sku` opcional)
`agent_bootstrap`	Integração sem intervenção humana: token de inicialização por e-mail (sem e-mail de saída)
`keys_create`	Gera uma chave de execução/sub a partir de uma chave de conta `tp_`
`kvp_put`	Armazena uma string sob um namespace/chave (a resposta inclui `budget`)
`kvp_get`	Lê um valor com namespace
`kvp_delete`	Exclui uma chave KVP
`kvp_list`	Lista chaves em um namespace
`file_upload`	Envia texto UTF-8 para indexação RAG (prefLights `rag_index`)
`files_list`	Lista arquivos enviados
`files_types`	Extensões de upload suportadas e tipos MIME
`rag_search`	Busca semântica sobre documentos indexados
`inspect_storage`	Inventário de namespaces (escopo limitado à chave quando aplicável)
`run_finish`	Apaga namespaces vinculados a esta chave de execução; retorna um recibo de exclusão assinado
`support_contact`	Contata o suporte do Tillpad a partir de uma conta Pro; as respostas vão para o e-mail da conta

Loop típico de agente

Gere uma chave de execução no painel (namespace dedicado, TTL, orçamento de operações opcional).
Armazene o estado de trabalho com kvp_put e/ou file_upload.
Recupere com kvp_get / kvp_list e rag_search.
Chame run_finish para apagar namespaces de execução e manter o recibo assinado.

Use budget_estimate antes de grandes trabalhos de indexação. budget_get / usage_get mostram o que resta no período.

Autenticação e erros

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

Isto é Stripe Machine Payments Protocol, nã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; consulte 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/number1101/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 17 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 locais rápidos.

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.