Zusammenfassung
USPS APIs für Versender: US-Adressen validieren und ZIP-Codes nachschlagen, nationale und internationale Preise vergleichen, Lieferzeiten und Versandoptionen erhalten, Pakete verfolgen und Postämter, Abgabestellen und Paketfächer finden. Etiketten, Rückerstattungen, Abholungen und SCAN-Formulare sind enthalten, aber deaktiviert. Consumer Key und Secret einer App im USPS Customer Onboarding Portal.
Geführte Einrichtung
USPS in 2 Minuten mit Claude, ChatGPT oder Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde USPS in der geführten Einrichtung und trag deine MCP-URL in deinen KI-Assistenten ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für USPS
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → USPS, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
USPS
USPS APIs für Versender: US-Adressen validieren und ZIP-Codes nachschlagen, nationale und internationale Preise vergleichen, Lieferzeiten und Versandoptionen erhalten, Pakete verfolgen und Postämter, Abgabestellen und Paketfächer finden. Etiketten, Rückerstattungen, Abholungen und SCAN-Formulare sind enthalten, aber deaktiviert. Consumer Key und Secret einer App im USPS Customer Onboarding Portal.
Einrichtung
Die Einrichtung dauert etwa 15 Minuten.
- Öffne das USPS Customer Onboarding Portal unter https://cop.usps.com/cop-navigator?wf=API und melde dich mit deinem USPS Business Account an oder erstelle dort einen. Das Portal bereitet das Konto für die USPS APIs vor.
- Wähle Meine Apps oben im Portal und füge eine App hinzu.
- Öffne die App. Kopiere in Zugangsdaten den Consumer Key in
USPS_CLIENT_IDund das Consumer Secret inUSPS_CLIENT_SECRET. - Wähle die API-Adresse in
USPS_API_HOST: Produktionhttps://apis.usps.comoder die Testumgebung für Versenderhttps://apis-tem.usps.com. Beide verwenden die gleichen Produktions-Zugangsdaten. Etiketten, die auf dem Test-Host erstellt werden, sind mit Wasserzeichen versehen und werden nie berechnet. USPS veröffentlicht den Test-Host für jede API außer Tracking, also bleibe bei Produktion, wenn du hauptsächlich verfolgst. - Optional, für Etiketten und Vertragspreise: deine CRID, Mailer ID und die Nummer des Enterprise Payment Accounts in
USPS_CRID,USPS_MIDundUSPS_EPS_ACCOUNT_NUMBER. Der Business Service Administrator deines Business Customer Gateway-Kontos hat diese.
Der Connector sendet den Consumer Key und das Secret an /oauth2/v3/token auf dem gewählten Host (Client-Zugangsdaten) und erhält ein Bearer-Token, das etwa 8 Stunden gültig ist, welches er selbst wiederverwendet und erneuert.
Was eine neue App verwenden kann: jede App beginnt mit dem USPS-Standardprodukt: OAuth, Adressen, nationale Preise, internationale Preise, Standorte, Service-Standards, Versandoptionen und Tracking. Adressen, Preise, Lieferzeiten, Versandoptionen, Tracking, Postämter und Abgabestellen funktionieren daher sofort. Carrier Pickup, Zahlungen, Etiketten, internationale Etiketten und SCAN-Formulare benötigen die Genehmigung von USPS: frage danach mit einer USPS API-Serviceanfrage auf der Seite Email Us (https://emailus.usps.com/s/usps-APIs). Die Labels APIs benötigen auch die Anmeldung bei USPS Ship (ausgehende und Rücksendungen) und ein Enterprise Payment Account (EPS), das die Portokosten bezahlt. Paketfächer (usps_find_parcel_lockers) und der internationale Service-Standard (usps_get_international_service_standard) haben eigene Scopes; wenn sie mit 403 antworten, frage USPS auf die gleiche Weise danach.
Wo du anfangen kannst: usps_get_city_state mit einer ZIP-Code beweist die Verbindung. Für ein Angebot gibt usps_search_shipping_options Preise und Lieferdaten für jeden Service in einem Aufruf zurück; usps_search_domestic_prices und usps_search_international_prices geben die Preisaufschlüsselung mit zusätzlichen Services.
Adressen: usps_validate_address standardisiert eine US-Adresse und gibt die ZIP+4, DPVConfirmation (Y bestätigt, D sekundäre Nummer fehlt, S sekundäre Nummer nicht bestätigt, N nicht bestätigt), business (Y oder N) und vacant zurück. usps_get_zip_code findet die ZIP-Code einer Straße in einer Stadt und einem Bundesstaat, usps_get_city_state die Stadt und den Bundesstaat eines ZIP-Codes. Bundesstaaten sind zweibuchstabige Codes; nur US-Adressen (einschließlich Territorien und Militäradressen) sind abgedeckt.
Preise: Pakete werden in Pfund gewogen und in Zoll gemessen; Briefe, Flats und Karten werden in Unzen gewogen. price_type COMMERCIAL ist das, was du für online gekaufte Etiketten zahlst, RETAIL ist der Preis am Postamt, CONTRACT benötigt account_type und account_number. usps_search_domestic_prices gibt rateOptions mit totalBasePrice, totalPrice und den zusätzlichen Services zurück; usps_list_domestic_prices listet jedes berechtigte Produkt mit seiner SKU, rateIndicator und processingCategory, die Werte, die eine Etikettenanfrage benötigt. usps_search_letter_prices bepreist First-Class Mail Briefe, Flats und Postkarten. Im Ausland: usps_search_international_prices (optional mit Zöllen und Steuern pro Artikel), usps_list_international_prices und usps_search_international_letter_prices. Versanddaten können heute bis zu 7 Tage im Voraus sein. Beträge sind in US-Dollar. USPS_GROUND_ADVANTAGE ersetzt den First-Class Package Service und Retail Ground.
Lieferzeiten: usps_get_delivery_estimates gibt das geplante Lieferdatum für einen Versandtag an, mit der Annahmeschlusszeit (cutOffTime, HHMM lokal); usps_get_service_standards die Standardanzahl von Tagen pro Postklasse; usps_get_international_service_standard einen Satz wie Geschätzte Lieferung in 5-9 Werktagen. Ein Service-Standard ist ein Ziel, keine Garantie.
Tracking: usps_track_package für eine Nummer, usps_track_packages für bis zu 35 auf einmal. Beide verwenden Tracking 3.2; die veraltete Tracking 3.0 API wird am 31. Juli 2027 eingestellt. Die Antwort hat statusCategory, statusSummary, trackingEvents (eventTimestamp in lokaler Zeit des Ereignisses, GMTTimestamp in UTC), deliveryDateExpectation und uniqueTrackingID. Ein Batch antwortet mit HTTP 207, wenn einige Nummern fehlschlagen, und jede fehlgeschlagene Nummer trägt ihren eigenen error. usps_register_tracking_notifications meldet bis zu 3 E-Mail-Adressen für Tracking-E-Mails an und usps_request_proof_of_delivery hat einen Zustellnachweisbrief, der per E-Mail versendet wird; beide benötigen die uniqueTrackingID einer Tracking-Antwort, senden E-Mails von USPS und kosten nichts.
Standorte: usps_find_post_offices sucht nach ZIP-Code, Stadt und Bundesstaat, Adresse oder Koordinaten (Radius in Meilen, standardmäßig 20) und listet die Öffnungszeiten jedes Dienstes auf; usps_find_dropoff_locations listet die Zielabgabestellen für Parcel Select, USPS Connect und Paketdienste nach Ziel-ZIP-Code auf; usps_find_parcel_lockers findet Paketfächer.
Abholungen: usps_check_pickup_eligibility und usps_get_pickup sind nur lesend. usps_schedule_pickup bucht die kostenlose Carrier Pickup (Montag bis Samstag) und usps_cancel_pickup storniert eine; beide sind deaktiviert. Eine Abholung kann hier nicht geändert werden: storniere sie und buche eine neue.
Etiketten (deaktiviert): jeder Etikettenaufruf benötigt ein Zahlungsgenehmigungstoken. usps_create_payment_authorization mit deiner CRID, Mailer ID und EPS-Konto gibt paymentAuthorizationToken zurück; übergebe es an usps_create_label, usps_create_return_label, usps_create_international_label, usps_cancel_label oder usps_cancel_international_label. Etiketten kommen als JSON zurück: labelMetadata mit der Sendungsverfolgungsnummer und dem Porto sowie labelImage in base64 (standardmäßig ein 4x6 PDF). Das Erstellen eines Etiketts kauft Porto vom EPS-Konto. Eine Stornierung antwortet mit CANCELED oder DISPUTED mit einer disputeId, wenn USPS eine Rückerstattungsanfrage eröffnet hat. usps_get_payment_account liest das Konto und teilt mit, ob die Mittel ausreichen, wenn amount angegeben ist. usps_create_scan_form platziert viele Etiketten auf einem PS Form 5630 für einen einzigen Annahmescan. Schalte diese Tools erst ein, nachdem USPS die Labels APIs genehmigt hat, und teste sie zuerst auf dem Test-Host.
Fehler: Fehler werden als error mit code, message und einer Liste errors (title, detail, source.parameter) zurückgegeben. 400 nennt das falsche Feld; 401 bedeutet falsche Zugangsdaten oder ein abgelaufenes Token; 403 bedeutet, dass die App diese API nicht hat (sie liegt außerhalb des Standardprodukts); 404 bedeutet, dass USPS nichts gefunden hat, z.B. eine unbekannte Sendungsverfolgungsnummer.
Limits: jede App hat ein Kontingent an Aufrufen pro Stunde; ein 429 bedeutet, dass es bis zur nächsten Stunde aufgebraucht ist. USPS erhöht das Kontingent auf Anfrage über die Seite Email Us. Daten sind im Format YYYY-MM-DD.
Voraussetzungen: USPS_CLIENT_ID, USPS_CLIENT_SECRET, USPS_API_HOST
Installiere den Connector lokal
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Öffne http://localhost:3000/connectors/store, wähle USPS und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
usps_validate_address | Validiert und standardisiert eine US-Adresse. Gibt address in USPS-Standardform zurück (streetAddress, city, state, ZIPCode, ZIPPlus4)… |
usps_get_city_state | Schlägt die Stadt und den Bundesstaat eines 5-stelligen ZIP-Codes nach. Gibt city (in Großbuchstaben), state (zwei Buchstaben) und ZIPCode zurück. Günstiger Aufruf, verwendet als… |
usps_get_zip_code | Findet die ZIP-Code und ZIP+4 einer Straßenadresse in einer Stadt und einem Bundesstaat. Gibt address mit der standardisierten Straße, city, state… zurück |
usps_search_domestic_prices | Bepreist ein nationales Paket über Postklassen, zusätzliche Services inklusive. Gibt rateOptions zurück, eine pro berechtigtem Produkt, jede mit… |
usps_list_domestic_prices | Listet jedes Produkt auf, für das ein nationales Paket berechtigt ist, mit seinem Basispreis und ohne zusätzliche Services. Gibt rateOptions mit… zurück |
usps_search_letter_prices | Bepreist einen First-Class Mail Brief, Flat (großer Umschlag) oder Postkarte, die innerhalb der USA versendet wird. Gibt totalBasePrice und rates (SKU… zurück |
usps_search_international_prices | Bepreist ein ausgehendes internationales Paket, zusätzliche Services inklusive und auf Anfrage Zölle und Steuern pro Artikel. Gibt rateOptions zurück, eine pro… |
usps_list_international_prices | Listet jedes internationale Produkt auf, für das ein ausgehendes Paket berechtigt ist, mit Basispreisen und ohne zusätzliche Services. Gibt rateOptions mit… zurück |
usps_search_international_letter_prices | Bepreist einen First-Class Mail International Brief, Flat oder Postkarte. Gibt totalBasePrice, rates (SKU, description, price, fees)… zurück |
usps_get_delivery_estimates | Schätzt das Lieferdatum von Post, die an einem bestimmten Tag angenommen wurde. Gibt eine Liste zurück, einen Eintrag pro Postklasse, mit serviceStandard (Tage)… |
usps_get_service_standards | Gibt die standardmäßige Anzahl von Liefer Tagen zwischen zwei ZIP-Codes pro Postklasse zurück. Gibt eine Liste mit mailClass, days… zurück |
usps_get_international_service_standard | Gibt die erwartete Lieferzeit einer internationalen Postklasse in ein Land zurück. Gibt countryCode, mailClass und… zurück |
usps_search_shipping_options | Vergleicht jede Möglichkeit, ein Paket in einem einzigen Aufruf zu versenden: Preise und Lieferverpflichtungen zusammen, national oder international. Gibt… zurück |
usps_track_package | Verfolgt ein USPS-Paket mit Tracking 3.2. Gibt trackingNumber, uniqueTrackingID, mailClass, status, statusCategory (z.B.… zurück |
usps_track_packages | Verfolgt bis zu 35 USPS-Pakete in einem Aufruf mit Tracking 3.2. Gibt ein Ergebnis pro Nummer mit trackingNumber, uniqueTrackingID… zurück |
usps_register_tracking_notifications | Meldet bis zu 3 E-Mail-Adressen für USPS-Tracking-E-Mails zu einem Paket an: erwartete Lieferupdates, Lieferaktivitäten oder alle Updates. Benötigt… |
usps_request_proof_of_delivery | Lässt USPS einen Zustellnachweisbrief (oder einen elektronischen Rückschein) für ein zugestelltes Paket an bis zu 3 Empfänger per E-Mail senden. Benötigt die… |
usps_find_post_offices | Findet Postämter und andere Einzelhandelsstandorte in der Nähe eines ZIP-Codes, einer Adresse oder Koordinaten, am nächsten zuerst. Gibt locations mit… zurück |
usps_find_dropoff_locations | Findet die Zielabgabestellen, an denen du Post für Parcel Select, USPS Connect und Paketdienste für einen Ziel-ZIP-Code abgeben kannst… |
usps_find_parcel_lockers | Findet USPS-Paketfächer nach ZIP-Code oder nach Stadt und Bundesstaat. Gibt eine Liste von Fächern mit facilityID, locationName, locationAddress… zurück |
usps_check_pickup_eligibility | Überprüft, ob USPS eine kostenlose Carrier Pickup an einer Adresse anbietet. Antwortet mit 200 und pickupAddress in standardisierter Form, wenn die Adresse… |
usps_get_pickup | Holt eine geplante Carrier Pickup mit der Bestätigungsnummer. Gibt confirmationNumber, pickupDate und carrierPickupRequest (Adresse… zurück |
usps_get_payment_account | Überprüft ein Enterprise Payment Account oder eine Genehmigung. Gibt die Kontodaten zurück und, wenn amount angegeben ist, sufficientFunds (true oder false)… |
usps_create_payment_authorization | Holt das Zahlungsgenehmigungstoken, das jeder Etikettenaufruf benötigt: benennt dein Unternehmen als PAYER und LABEL_OWNER mit seiner CRID, Mailer ID und… |
usps_create_label | Kauft Porto und erstellt ein nationales Versandetikett, das aus dem Enterprise Payment Account im Zahlungsgenehmigungstoken bezahlt wird. Gibt… zurück |
usps_create_return_label | Erstellt ein nationales Rücksendeetikett für einen Kunden, um ein Paket zurückzusenden (to_address ist deine Rücksendeadresse, from_address der Kunde).… |
usps_cancel_label | Storniert ein ungenutztes nationales Etikett oder beantragt eine Rückerstattung des Portos. Gibt trackingNumber, status (CANCELED oder DISPUTED, wenn eine Rückerstattung… zurück |
usps_create_international_label | Kauft Porto und erstellt ein internationales Etikett mit seinem Zollformular (First-Class Package International Service, Priority Mail International… |
usps_cancel_international_label | Storniert ein ungenutztes internationales Etikett oder beantragt eine Rückerstattung des Portos. Gibt die Sendungsverfolgungsnummer, status (CANCELED oder DISPUTED) und die… zurück |
usps_schedule_pickup | Bucht eine kostenlose USPS Carrier Pickup für Pakete an deiner Adresse (Montag bis Samstag; nur am selben Tag bis 2 Uhr Central Time). Gibt… zurück |
usps_cancel_pickup | Storniert eine geplante Carrier Pickup mit der Bestätigungsnummer. Gibt 200 zurück, wenn storniert. Installiert deaktiviert: Stornierungen bleiben bei einer… |
usps_create_scan_form | Erstellt ein SCAN-Formular (PS Form 5630), das Etiketten mit einem Barcode verknüpft, sodass ein einzelner Scan bei der Annahme jedes Paket erfasst. Gibt… zurück |
Beispielaufforderungen
- "Wo ist das USPS-Paket 9400111899223197428490?"
- "Ist 1600 Pennsylvania Ave NW, Washington DC 20500 eine gültige Adresse, und was ist ihre ZIP+4?"
- "Vergleiche die USPS-Preise und Lieferdaten für ein 3 lb Paket von 10001 nach 94105, das morgen versendet wird."
- "Was kostet ein 2 lb Paket nach Toronto mit USPS Priority Mail International?"
- "Finde Postämter, die am Samstag in der Nähe von ZIP 60614 geöffnet sind."
Nächste Schritte
War dieser Guide hilfreich?