PostAgent

oficial

Imprima e envie correspondências físicas e cartões postais para endereços nos EUA (USPS), pagos por chamada em USDC na Base via x402 ou cartão de crédito.

GitHub
1

O que você pode fazer com Post Agent MCP?

  • Fazer upload de um documento para impressão — envie um arquivo PDF, HTML, Markdown, DOCX ou imagem para o PostAgent através da etapa upload.
  • Obter um orçamento antes do envio — verifique os endereços do remetente e do destinatário e receba um preço fixo em USDC válido por 15 minutos usando a etapa de cotação.
  • Pagar e enviar correspondência física — confirme a cotação para acionar o pagamento em USDC na Base e despachar o documento para um endereço postal dos EUA.
  • Rastrear um documento enviado — consulte o status do job e recupere as informações de rastreamento dos USPS para uma peça de correspondência enviada anteriormente.

Documentação

PostAgent — Impressão e Envio Postal (Habilidade do Agente)

Uma habilidade de agente instalável que permite ao seu agente de codificação com IA imprimir e enviar fisicamente um documento (PDF, HTML, Markdown, texto, DOCX ou imagem) para um endereço postal nos EUA via a API do PostAgent. Cada envio é pago por chamada em USDC na Base usando o protocolo de pagamento x402, e então processado pelo fluxo de impressão e envio do PostAgent.

Enviar correspondência gasta dinheiro real e é irreversível uma vez submetido. A habilidade sempre faz uma cotação primeiro e requer confirmação explícita do usuário antes de pagar.

Instalação

Claude Code (global) — sempre passe -a claude-code para que ele fique em ~/.claude/skills/, o único local de onde o Claude Code lê as habilidades:

npx skills add interpretai-tech/agent-tools --skill postagent-print-and-mail -g -a claude-code -y

Então reinicie o Claude Code — a lista de habilidades é lida uma vez no início da sessão, então uma habilidade recém-instalada não aparecerá até que você reinicie.

Outros agentes (detectados automaticamente — instala no diretório de habilidades próprio de cada agente, ex.: .agents/skills/ para Codex/Cursor/Gemini):

npx skills add interpretai-tech/agent-tools --skill postagent-print-and-mail -y

Sem -a claude-code, a CLI pode instalar apenas no caminho genérico .agents/skills/, que o Claude Code não lê — a habilidade aparecerá como "instalada", mas nunca carregará.

-y pula o prompt interativo de escopo/confirmação. Omita-o se preferir confirmar o escopo e revisar antes de instalar.

O que faz

  1. Upload de um documento (grátis) — carta finalizada ou modelo de mala direta {{field}}.
  2. Cotação (grátis) — verifica os endereços do remetente e destinatário e fixa um preço inclusivo em USDC por 15 minutos.
  3. Pagamento — a carteira x402 do agente paga o paymentUrl da cotação; o PostAgent imprime e envia a carta.
  4. Rastreamento (grátis) — consulta o status do trabalho e o rastreamento dos USPS.

Funciona em qualquer agente via API REST (HTTP simples, sem configuração) — e opcionalmente via o servidor MCP do PostAgent (https://api.postagent.sh/mcp) quando estiver configurado. Veja SKILL.md para as instruções completas que o agente segue.

Requisitos

  • Um endereço de remetente e um de destinatário nos EUA (código de estado de 2 letras, 5 dígitos/ZIP+4).
  • Uma carteira compatível com x402 com USDC na mainnet da Base para pagar por envio.

Licença

MIT