PostAgent

officiel

Imprimer et envoyer du courrier physique et des cartes postales vers des adresses aux États-Unis (USPS), payé par appel en USDC sur Base via x402 ou carte de crédit.

Que pouvez-vous faire avec PostAgent MCP ?

  • Upload a document for printing — send a PDF, HTML, Markdown, DOCX, or image file to PostAgent via the step.
  • Get a price quote before mailing — verify sender and recipient addresses and receive a locked USDC price valid for 15 minutes using the quote step.
  • Pay and send physical mail — confirm the quote to trigger payment in USDC on Base and dispatch the document to a US postal address.
  • Track a mailed document — poll job status and retrieve USPS tracking information for a previously submitted mail piece.

Documentation

PostAgent — Imprimer et Poster (Compétence d'Agent)

Une compétence d'agent installable qui permet à votre agent de codage IA d'imprimer et d'envoyer physiquement par courrier un document (PDF, HTML, Markdown, texte, DOCX ou image) à une adresse postale américaine via l'API PostAgent. Chaque envoi est payé à l'appel en USDC sur Base en utilisant le protocole de paiement x402, puis pris en charge par le flux de travail d'impression et d'envoi de PostAgent.

L'envoi de courrier dépense de l'argent réel et est irréversible une fois soumis. La compétence fournit toujours un devis d'abord et nécessite une confirmation explicite de l'utilisateur avant de payer.

Installation

Claude Code (global) — passez toujours -a claude-code pour qu'il atterrisse dans ~/.claude/skills/, le seul emplacement où Claude Code lit les compétences :

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

Puis redémarrez Claude Code — la liste des compétences est lue une fois au démarrage de la session, donc une compétence nouvellement installée n'apparaîtra pas avant que vous ne relanciez.

Autres agents (détection automatique — s'installe dans le répertoire de compétences propre à chaque agent, par ex. .agents/skills/ pour Codex/Cursor/Gemini) :

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

Sans -a claude-code, la CLI peut s'installer uniquement dans le chemin générique .agents/skills/, que Claude Code ne lit pas — la compétence apparaîtra comme "installée" mais ne se chargera jamais.

-y ignore l'invite interactive de portée/confirmation. Omettez-le si vous préférez confirmer la portée et vérifier avant l'installation.

Ce que cela fait

  1. Téléverser un document (gratuit) — lettre finie ou modèle de publipostage {{field}}.
  2. Devis (gratuit) — vérifie les adresses de l'expéditeur et du destinataire et bloque un prix inclusif en USDC pendant 15 minutes.
  3. Payer — le portefeuille x402 de l'agent paie le paymentUrl du devis ; PostAgent imprime et envoie la lettre.
  4. Suivre (gratuit) — interroger l'état du travail et le suivi USPS.

Fonctionne dans n'importe quel agent via l'API REST (HTTP simple, sans configuration) — et optionnellement via le serveur MCP PostAgent (https://api.postagent.sh/mcp) lorsqu'il est configuré. Voir SKILL.md pour les instructions complètes que l'agent suit.

Prérequis

  • Une adresse d'expéditeur et de destinataire aux États-Unis (code d'État à 2 lettres, code postal à 5 chiffres/ZIP+4).
  • Un portefeuille compatible x402 avec des USDC sur le réseau principal Base pour payer chaque envoi.

Licence

MIT