PostAgent

offiziell

Drucken und versenden Sie physische Briefe und Postkarten an US-Adressen (USPS), bezahlt pro Aufruf in USDC auf Base via x402 oder Kreditkarte.

GitHub
1

Was kann man mit Post Agent MCP machen?

  • Dokument zum Drucken hochladen — Senden Sie eine PDF-, HTML-, Markdown-, DOCX- oder Bilddatei über den Schritt upload an PostAgent.
  • Vor dem Versand ein Preisangebot einholen — Überprüfen Sie die Absender- und Empfängeradressen und erhalten Sie einen für 15 Minuten gültigen, festgeschriebenen USDC-Preis mithilfe des Schritts quote.
  • Bezahlen und physische Post versenden — Bestätigen Sie das Angebot, um die Zahlung in USDC auf Base auszulösen und das Dokument an eine US-Postadresse zu versenden.
  • Ein versendetes Dokument verfolgen — Fragen Sie den Auftragsstatus ab und rufen Sie USPS-Sendungsverfolgungsinformationen für ein zuvor eingereichtes Poststück ab.

Dokumentation

PostAgent — Druck & Postversand (Agent Skill)

Eine installierbare Agent-Fähigkeit, die es Ihrem KI-Coding-Agenten ermöglicht, ein Dokument (PDF, HTML, Markdown, Text, DOCX oder Bild) an eine US-Postadresse über die PostAgent-API zu drucken und physisch zu versenden. Jeder Versand wird pro Aufruf in USDC auf Base über das x402-Zahlungsprotokoll bezahlt und anschließend vom Druck-und-Versand-Workflow von PostAgent abgewickelt.

Der Versand von Post kostet echtes Geld und ist nach der Einreichung unwiderruflich. Die Fähigkeit erstellt immer zuerst ein Angebot und erfordert eine ausdrückliche Bestätigung durch den Benutzer, bevor bezahlt wird.

Installation

Claude Code (global) — übergeben Sie immer -a claude-code, damit es in ~/.claude/skills/ landet, dem einzigen Ort, aus dem Claude Code Fähigkeiten liest:

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

Dann starten Sie Claude Code neu — die Fähigkeitenliste wird einmal zu Sitzungsbeginn gelesen, sodass eine neu installierte Fähigkeit erst nach einem Neustart angezeigt wird.

Andere Agenten (automatisch erkannt — installiert in das jeweilige Fähigkeitenverzeichnis des Agenten, z. B. .agents/skills/ für Codex/Cursor/Gemini):

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

Ohne -a claude-code installiert die CLI möglicherweise nur in den generischen .agents/skills/-Pfad, den Claude Code nicht liest — die Fähigkeit erscheint dann als „installiert“, wird aber nie geladen.

-y überspringt die interaktive Bereichs-/Bestätigungsabfrage. Lassen Sie es weg, wenn Sie den Bereich bestätigen und vor der Installation überprüfen möchten.

Funktionsweise

  1. Hochladen eines Dokuments (kostenlos) — fertiger Brief oder {{field}}-Serienbriefvorlage.
  2. Angebot (kostenlos) — überprüft Absender-/Empfängeradressen und sichert einen USDC-Inklusivpreis für 15 Minuten.
  3. Bezahlen — die x402-Wallet des Agenten bezahlt das paymentUrl des Angebots; PostAgent druckt und versendet den Brief.
  4. Verfolgen (kostenlos) — Auftragsstatus und USPS-Sendungsverfolgung abfragen.

Funktioniert in jedem Agenten über die REST-API (reines HTTP, keine Einrichtung) — und optional über den PostAgent MCP-Server (https://api.postagent.sh/mcp), wenn dieser konfiguriert ist. Siehe SKILL.md für die vollständigen Anweisungen, denen der Agent folgt.

Voraussetzungen

  • Eine US-Absender- und eine US-Empfängeradresse (2-Buchstaben-Bundesstaatkürzel, 5-stellige PLZ/ZIP+4).
  • Eine x402-fähige Wallet mit USDC auf dem Base-Mainnet, um pro Versand zu bezahlen.

Lizenz

MIT