convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
forgesworn

Toll Booth MCP - Monitor de Gateways de Pagamento

forgesworn/toll-booth-mcp

Dashboard interativo para monitorar pagamentos Lightning e receita em toll-booth

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para monitoramento em tempo real de deployments toll-booth, um gateway de pagamento Lightning. Fornece análise de histórico de pagamentos, serviços ativos, receita agregada e sessões de crédito através de widgets interativos. Acesso somente leitura ao banco SQLite com suporte a redação de PII.

Instalação

$npx convez-ai forgesworn/toll-booth-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
62%
Último commit
há 3 dias
Versão
—
Issues abertas
3
Contribuidores
2

Casos de uso

  • Monitorar histórico de pagamentos e estatísticas de receita em tempo real
  • Analisar endpoints protegidos agrupados por camada de preço e métricas de pagamento
  • Gerenciar sessões de crédito e saldos ativos com widgets interativos
  • Auditar atividade de gateway de pagamento com dados sensíveis redatados

Veredito

Ferramenta especializada e bem construída para operadores de gateways Lightning payment. Arquitetura robusta com segurança de privacidade integrada (redação de PII), widgets interativos e suporte a transporte HTTP para deployments remotos. Nicho específico mas solução completa para seu caso de uso.

README

A tradução para o português deste README ainda está na fila.

forgesworn/toll-booth-mcp

GitHub Sponsors

Admin MCP server for monitoring toll-booth deployments. Read-only analytics with interactive widgets for a Lightning payment gateway.

What it does

Attaches to a toll-booth SQLite database in read-only mode and exposes analytics as MCP tools. Pair it with an MCP client (Claude Desktop, Cursor, Zed, etc.) and get live visibility into:

  • Payment history: sats received over time as a chart with summary statistics
  • Services: active gated endpoints grouped by pricing tier with payment statistics
  • Revenue: aggregate revenue statistics across all toll-booth payments
  • Sessions and credits: active payment sessions and credit balances (opt-in detail tools)

Three of the tools register interactive UI widgets via the MCP ext-apps bundle. Clients that support widgets render them inline; other clients fall back to the JSON response.

Install

From source (while unpublished):

git clone https://github.com/forgesworn/toll-booth-mcp.git
cd toll-booth-mcp
npm install
npm run build

Requires Node >= 20.

Configuration

All configuration via environment variables:

VariableDefaultDescription
TOLL_BOOTH_DB./toll-booth.dbPath to the toll-booth SQLite database
TRANSPORTstdiostdio or http
PORT3500HTTP listen port (HTTP transport only)
BIND_ADDRESS127.0.0.1HTTP bind address (HTTP transport only)
REDACT_PIItrueHash payment hashes and strip session IDs before returning data to the client
ALLOW_DETAIL_TOOLSfalseRegister booth-recent-payments, booth-credits, booth-sessions (return PII-adjacent rows)

Setting REDACT_PII=false emits a stderr warning — full identifiers are then exposed to whichever AI platform drives the MCP client.

MCP client setup

Claude Desktop / Cursor / stdio

{
  "mcpServers": {
    "toll-booth": {
      "command": "node",
      "args": ["/absolute/path/to/toll-booth-mcp/dist/src/index.js"],
      "env": {
        "TOLL_BOOTH_DB": "/absolute/path/to/toll-booth.db"
      }
    }
  }
}

HTTP transport (remote deployments)

TRANSPORT=http TOLL_BOOTH_DB=/path/to/db npm start

On startup the server prints a bearer token to stderr. Send it as the Authorization: Bearer <token> header from your MCP client. The HTTP server rate-limits at 60 requests per minute per IP and validates the bearer with constant-time comparison.

Tools

ToolReturns
booth-statusDatabase connection state
booth-payment-historySats received over a window (default 30 days), chart + summary
booth-servicesActive gated endpoints grouped by tier with payment statistics
booth-revenueAggregate revenue statistics
booth-recent-paymentsRecent settled payments (detail, opt-in)
booth-creditsActive credit balances above a threshold (detail, opt-in)
booth-sessionsOpen IETF Payment sessions (detail, opt-in)

Detail tools are gated behind ALLOW_DETAIL_TOOLS=true because they return per-row data with PII adjacency even after redaction.

Read-only by design

The MCP server opens the database with { readonly: true, fileMustExist: true } via better-sqlite3. No write tools are registered. Compromise of the MCP client cannot alter toll-booth state — the worst it can do is read data the server is configured to expose.

Develop

npm install
npm run build   # compile server + bundle widgets
npm test        # vitest

Widgets are built from widgets/ into inline HTML bundles during npm run build. The server loads them at runtime and serves them as MCP resources.

Licence

MIT. See LICENCE.

Ver o original no GitHub

Bom para

Relacionados