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.

GitHub
1

Que pouvez-vous faire avec Post Agent MCP ?

  • Télécharger un document pour impression — envoyez un fichier PDF, HTML, Markdown, DOCX ou image à PostAgent via l'étape upload.
  • Obtenir un devis avant l'envoi — vérifiez les adresses de l'expéditeur et du destinataire et recevez un prix verrouillé en USDC valable 15 minutes à l'aide de l'étape quote.
  • Payer et envoyer un courrier physique — confirmez le devis pour déclencher le paiement en USDC sur Base et expédier le document à une adresse postale américaine.
  • Suivre un document envoyé — interrogez l'état d'une tâche et récupérez les informations de suivi USPS pour un envoi postal précédemment soumis.

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