Payload Sample MCP Server

Payload Sample MCP Server

Um servidor MCP real e instalável (SDK Python oficial do mcp, transporte stdio) que demonstra o mecanismo central do Payload MCP Monetization Kit pago: medição por chamada de ferramenta com cota gratuita e, em seguida, uma resposta PAYMENT_REQUIRED legível por máquina quando a cota é esgotada.

Pequeno software que ganha seu sustento.

O que ele faz

Ferramenta	Nível	O que faz
word_count	GRATUITO, ilimitado	Conta palavras, caracteres e linhas do texto de entrada.
summarize	PREMIUM	Resumo extrativo ingênuo de texto.
extract_keywords	PREMIUM	Extração ingênua de palavras-chave de texto.

O mecanismo de cota gratuita

As ferramentas premium têm uma cota gratuita (padrão 5 chamadas, env PAYLOAD_FREE_QUOTA). Depois disso, o servidor responde com um payload JSON PAYMENT_REQUIRED legível por máquina no estilo x402 — ele não trava e não coleta nenhum pagamento real:

{
  "status": "PAYMENT_REQUIRED",
  "tool": "summarize",
  "free_quota": 5,
  "premium_calls_used": 5,
  "upgrade_url": "https://payloadtools.gumroad.com/l/mcp-monetization-kit",
  "message": "Free quota exhausted (5/5 premium calls used). Attach payment to continue, or get the full MCP Monetization Kit to collect real per-call USDC payments with the x402 flow: ..."
}

Um limite máximo (padrão 200 chamadas no total, env PAYLOAD_HARD_CAP) impede que este exemplo seja usado como um serviço gratuito. A medição é feita em memória e é redefinida a cada reinicialização.

Instalação e execução

Requer Python 3.10+.

pip install payload-sample-mcp-server
payload-sample-mcp-server

Usar no Claude Desktop

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

{
  "mcpServers": {
    "payload-sample": {
      "command": "payload-sample-mcp-server"
    }
  }
}

Usar no Cursor

Adicione às suas configurações de MCP do Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "payload-sample": {
      "command": "payload-sample-mcp-server"
    }
  }
}

Para executar a partir do código-fonte:

git clone https://github.com/Payloadhq/payload-sample-mcp-server
cd payload-sample-mcp-server
pip install -e .
payload-sample-mcp-server

O que está deliberadamente ausente (os kits pagos)

Este exemplo prova que o mecanismo de monetização funciona. Ele não substitui os produtos pagos:

• Coleta de pagamento real. O MCP Monetization Kit ($69) coleta pagamentos reais em USDC por chamada por meio do fluxo x402, com dois verificadores (verificador HMAC de desenvolvimento para testes, verificador facilitador para produção) — sem custódia, ele verifica o pagamento e então executa sua ferramenta. Ele inclui um registro de ferramentas pagas (registerTool / callTool / listTools) com preços por ferramenta, lógica de cota gratuita, um registro de uso somente de acréscimo, o adaptador oficial do SDK sobre o transporte stdio, 15 testes automatizados e um servidor de exemplo funcional e um cliente de exemplo pagante.
• Reforço de segurança. O exemplo é intencionalmente não autenticado. O MCP Launch Readiness Audit ($79) oferece um scanner de 48 regras com correções concretas, modelos de servidor endurecidos (Python e TypeScript) com autenticação por token de portador, escopos e limites de taxa por ferramenta, um harness de teste de estresse de confiabilidade, um verificador de prontidão de implantação, integração com CI, uma suíte de regressão e um relatório de auditoria em PDF com marca.
• APIs pagas via x402. O x402 Paid API Starter Kit ($79) cobra agentes de IA por chamada de API em USDC: middleware de rota paga, gerador de manifesto /.well-known/x402, verificadores HMAC + facilitador, registro de uso somente de acréscimo, servidor de exemplo funcional, 9 testes automatizados. Sem custódia por design.

Ecossistema Payload

• Todos os produtos Payload — https://payloadtools.gumroad.com
• Mais repositórios Payload — https://github.com/Payloadhq

Suporte: kylers.partners@gmail.com · "Pequeno software que ganha seu sustento."

Licença

MIT — consulte LICENSE.