AgentPostage

npx add-mcp 'https://agentpostage.com/mcp'

AgentPostage

Seu agente pode escrever a carta. Agora ele pode enviá-la pelo correio.

O AgentPostage transforma um PDF, um endereço de remetente nos EUA e um endereço de destinatário nos EUA em correspondência física. Envie disputas bancárias, cancelamentos de academia, solicitações a agências de crédito, avisos e formulários preenchidos pelo seu agente. Impressão, envelope, folha de rosto com endereço e postagem dos EUA estão incluídos.

Este repositório contém uma habilidade de envio portátil, plugins para Claude Code, Codex e Cursor, uma extensão para Gemini CLI e uma CLI Node.js independente. Conecte-se via MCP ou pela API HTTP, ou use uma Ação GPT privada no ChatGPT.

Comece aqui

1. Crie e verifique sua conta em Connect, aceite as políticas de serviço e crie uma chave de API nomeada.
2. Adicione fundos pré-pagos em Billing. O pagamento mínimo é de US$ 10. Não há assinatura.
3. Coloque a chave no cofre de segredos do seu agente como AGENTPOSTAGE_API_KEY e siga a configuração do seu agente. Nunca cole-a em uma conversa.

Instale a habilidade para um agente compatível com a CLI de habilidades:

npx skills add ctxrs/agentpostage --skill postage

Escolha o agente e o escopo de instalação quando solicitado. A habilidade se chama postage. Use /postage em clientes com comandos de barra de habilidades, ou $postage no Codex. A habilidade inclui sua própria CLI, sem dependências de pacotes. Instalá-la não envia correspondência nem financia uma conta.

Para qualquer agente com acesso ao shell e Node.js 22+, a CLI não precisa de instalação de pacotes:

curl -fsS https://agentpostage.com/agentpostage.mjs -o agentpostage.mjs
node agentpostage.mjs --help
node agentpostage.mjs balance
node agentpostage.mjs price --pages 3 --service first_class

Revise o código baixado antes de executá-lo. Verificações de saldo e preço não enviam correspondência. O código-fonte da CLI também está incluído neste repositório.

Envie meu PDF de cancelamento de academia para [endereço do destinatário] usando AgentPostage First-Class, com [meu endereço de remetente]. Registre o ID da carta e o custo e, em seguida, verifique o status do envio.

Seu agente age dentro da autoridade e dos limites que você já delegou. O AgentPostage não adiciona um fluxo de aprovação por carta.

Mais exemplos de prompts cobrem disputas bancárias, solicitações a agências de crédito, rastreamento e avisos de recebimento.

Escolha sua conexão

Agente ou runtime	Conexão
OpenClaw, Hermes Agent	Instale a habilidade com acesso ao shell ou use a configuração MCP remota deles
Codex	Instale o plugin de habilidade local do repositório ou configure MCP HTTP com uma variável de ambiente Bearer
Claude Code	Instale o plugin de habilidade ou conecte-se via MCP HTTP remoto
Cursor	Importe o repositório como plugin, instale a habilidade portátil ou conecte-se via MCP HTTP remoto
Gemini CLI	Instale a extensão para MCP remoto e as instruções compartilhadas de envio
ChatGPT	GPT personalizado privado com Actions e autenticação por chave de API
Muse, bots Grok e outros runtimes com capacidade de ferramentas	CLI, HTTP ou MCP remoto, onde o runtime expõe esses recursos

As instruções de configuração explicam pré-requisitos e limites. Apenas o nome de um modelo não fornece ferramentas nem permissão para enviar correspondência.

Quanto custa

Preços de varejo em USD, tarifa 2026-09-17-retail:

Serviço	Primeira página PDF em preto e branco
First-Class	US$ 4
First-Class com endosso Homeowner Statement Enclosed	US$ 4
First-Class flat	US$ 6
Certificado com rastreamento	US$ 12
Certificado com rastreamento e aviso de recebimento eletrônico	US$ 15

Cada página PDF adicional custa US$ 0,30. Cor adiciona US$ 0,30 por página PDF, incluindo a primeira. Papel não branco adiciona US$ 0,10 por folha do documento. Um envelope-resposta sem selo adiciona US$ 0,50, ou US$ 1,50 por pacote com doze unidades. Frente e verso mantém o preço por página e usa duas páginas do documento por folha. A folha de rosto com endereço está incluída, sem cobrança extra de página ou folha.

Você pode verificar um preço exato usando a contagem real de páginas do documento e as opções de impressão. A verificação de preço não garante uma tarifa. O envio fixa o preço atual quando a carta é enfileirada. Consulte a referência de preços atual.

Envie com cuidado

O envio coloca correspondência real e paga na fila imediatamente. Use o documento, os endereços, o serviço e as opções de impressão cobertos pela delegação existente do usuário. Humanos e hosts de agentes gerenciam seus próprios limites de gastos e permissões. Guarde uma chave de idempotência por carta pretendida e reutilize-a com entrada idêntica após um tempo limite. Uma nova chave pode criar correspondência duplicada.

queued significa salvo para envio. Não significa enviado. First-Class termina na confirmação de envio, sem confirmação individual de entrega. Certificado pode fornecer evidência de entrega, e um aviso de recebimento eletrônico pode chegar mais tarde.

O serviço aceita PDFs e endereços dos EUA. Ele não redige documentos, garante resultados legais nem promete uma data de entrega. Seu agente pode ajudar a preparar um PDF separadamente.

Referência e desenvolvimento

• API, CLI, limites de arquivo e tratamento de novas tentativas
• Configuração do agente e instalação do plugin Codex
• Habilidade de envio
• Documentação da API ao vivo, OpenAPI e referência do agente

Execute as verificações offline com Node.js 22+:

node --test tests/*.test.mjs

Os testes usam uma API mock local e dados sintéticos. Eles não enviam correspondência nem cobram de uma conta. Os arquivos de integração são licenciados sob MIT. O envio é um serviço pago regido pelas políticas aceitas durante a configuração da conta.