Guida al connettore12 minuti di lettura32 tool MCP7 lingue

USPS MCP per Cursor: tariffe e tracking

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

HCA cura del team HelpCodeAggiornato 12 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

USPS

USPS

USPS APIs for shippers: validate US addresses and look up ZIP Codes, compare domestic and international prices, get delivery days and shipping options, track packages, and find Post Offices, drop-off sites and Parcel Lockers. Labels, refunds, pickups and SCAN Forms are included but switched off. Consumer Key and Secret of an app in the USPS Customer Onboarding Portal.

tool

32

Regione

INTL

Categoria

Logistica

Autenticazione

OAuth 2.0

Env vars richieste

USPS_CLIENT_IDUSPS_CLIENT_SECRETUSPS_API_HOST
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Configurazione guidata

Collega USPS a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega USPS con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Prova a chiedere

Prompt di esempio per USPS

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

USPS · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → USPS, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

USPS + Cursor

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Prerequisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

USPS_CLIENT_ID, USPS_CLIENT_SECRET, USPS_API_HOST

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 15 minuti.

  1. Apri il Portale di Onboarding Clienti USPS su https://cop.usps.com/cop-navigator?wf=API e accedi con il tuo Account Business USPS, oppure creane uno lì. Il portale prepara l'account per le API USPS.
  2. Seleziona Le mie app in cima al portale e aggiungi un'app.
  3. Apri l'app. In Credenziali copia la Chiave del Consumatore in USPS_CLIENT_ID e il Segreto del Consumatore in USPS_CLIENT_SECRET.
  4. Scegli l'indirizzo API in USPS_API_HOST: produzione https://apis.usps.com, oppure l'Ambiente di Test per Spedizionieri https://apis-tem.usps.com. Entrambi richiedono le stesse credenziali di produzione. Le etichette create sull'host di test sono contrassegnate e non vengono mai addebitate. USPS pubblica l'host di test per ogni API tranne Tracking, quindi mantieni la produzione quando tracci principalmente.
  5. Facoltativo, per etichette e prezzi contrattuali: il tuo CRID, Mailer ID e numero di Conto di Pagamento Aziendale in USPS_CRID, USPS_MID e USPS_EPS_ACCOUNT_NUMBER. L'Amministratore del Servizio Aziendale del tuo account Business Customer Gateway li ha.

Il connettore invia la Chiave e il Segreto del Consumatore a /oauth2/v3/token sull'host scelto (credenziali client) e ottiene un token bearer valido per circa 8 ore, che riutilizza e rinnova autonomamente.

Cosa può utilizzare una nuova app: ogni app inizia con il prodotto predefinito USPS: OAuth, Indirizzi, Prezzi Nazionali, Prezzi Internazionali, Località, Standard di Servizio, Opzioni di Spedizione e Tracciamento. Pertanto, indirizzi, prezzi, giorni di consegna, opzioni di spedizione, tracciamento, Uffici Postali e località di consegna funzionano immediatamente. Il Ritiro del Corriere, i Pagamenti, le Etichette e gli SCAN Forms necessitano dell'approvazione USPS: richiedili con una richiesta di servizio API USPS nella pagina Contattaci (https://emailus.usps.com/s/usps-APIs). Le API delle Etichette necessitano anche dell'iscrizione a USPS Ship (etichette in uscita e di ritorno) e di un Conto di Pagamento Aziendale (EPS) che paga le spese di spedizione. I parcel lockers (usps_find_parcel_lockers) e lo standard di servizio internazionale (usps_get_international_service_standard) hanno ambiti propri; se rispondono 403, chiedi a USPS per loro nello stesso modo.

Da dove iniziare: usps_get_city_state con un codice ZIP prova la connessione. Per un preventivo, usps_search_shipping_options restituisce prezzi e date di consegna per ogni servizio in una sola chiamata; usps_search_domestic_prices e usps_search_international_prices forniscono il dettaglio dei prezzi con servizi extra.

Indirizzi: usps_validate_address standardizza un indirizzo statunitense e restituisce il ZIP+4, DPVConfirmation (Y confermato, D numero secondario mancante, S numero secondario non confermato, N non confermato), business (Y o N) e vacant. usps_get_zip_code trova il codice ZIP di una strada in una città e stato, usps_get_city_state la città e lo stato di un codice ZIP. Gli stati sono codici di due lettere; solo gli indirizzi statunitensi (inclusi territori e indirizzi militari) sono coperti.

Prezzi: i pacchi sono pesati in libbre e misurati in pollici; lettere, pacchi e cartoline sono pesati in once. price_type COMMERCIAL è ciò che paghi per le etichette acquistate online, RETAIL è il prezzo al banco dell'Ufficio Postale, CONTRACT richiede account_type e account_number. usps_search_domestic_prices restituisce rateOptions con totalBasePrice, totalPrice e i servizi extra; usps_list_domestic_prices elenca ogni prodotto idoneo con il suo SKU, rateIndicator e processingCategory, i valori necessari per una richiesta di etichetta. usps_search_letter_prices prezza le lettere di First-Class Mail, pacchi e cartoline. All'estero: usps_search_international_prices (opzionalmente con dazi e tasse per articolo), usps_list_international_prices e usps_search_international_letter_prices. Le date di invio possono essere oggi fino a 7 giorni in avanti. Gli importi sono in dollari statunitensi. USPS_GROUND_ADVANTAGE ha sostituito il First-Class Package Service e il Retail Ground.

Giorni di consegna: usps_get_delivery_estimates fornisce la data di consegna programmata per un giorno di invio, con l'orario di scadenza per l'accettazione (cutOffTime, HHMM locale); usps_get_service_standards il numero standard di giorni per classe di posta; usps_get_international_service_standard una frase come "Consegna stimata in 5-9 giorni lavorativi". Uno standard di servizio è un obiettivo, non una garanzia.

Tracciamento: usps_track_package per un numero, usps_track_packages per un massimo di 35 alla volta. Entrambi utilizzano Tracking 3.2; l'API di Tracking 3.0 legacy sarà ritirata il 31 luglio 2027. La risposta ha statusCategory, statusSummary, trackingEvents (eventTimestamp nell'ora locale dell'evento, GMTTimestamp in UTC), deliveryDateExpectation e uniqueTrackingID. Un batch risponde HTTP 207 quando alcuni numeri falliscono, e ogni numero fallito porta il proprio error. usps_register_tracking_notifications si iscrive a 3 indirizzi email per email di tracciamento e usps_request_proof_of_delivery ha una lettera di prova di consegna inviata via email; entrambi necessitano del uniqueTrackingID di una risposta di tracciamento, inviano email da USPS e non costano nulla.

Località: usps_find_post_offices cerca per codice ZIP, città e stato, indirizzo o coordinate (raggio in miglia, 20 di default) e elenca gli orari di ciascun servizio; usps_find_dropoff_locations elenca le strutture di ingresso di destinazione per Parcel Select, USPS Connect e servizi di pacchetti per un codice ZIP di destinazione; usps_find_parcel_lockers trova i Parcel Lockers.

Ritiri: usps_check_pickup_eligibility e usps_get_pickup solo lettura. usps_schedule_pickup prenota il ritiro gratuito del Corriere (da lunedì a sabato) e usps_cancel_pickup annulla uno; entrambi sono disattivati. Un ritiro non può essere modificato qui: annullalo e prenota uno nuovo.

Etichette (disattivate): ogni chiamata di etichetta necessita di un token di autorizzazione al pagamento. usps_create_payment_authorization con il tuo CRID, Mailer ID e conto EPS restituisce paymentAuthorizationToken; passalo a usps_create_label, usps_create_return_label, usps_create_international_label, usps_cancel_label o usps_cancel_international_label. Le etichette tornano come JSON: labelMetadata con il numero di tracciamento e le spese di spedizione, e labelImage in base64 (un PDF 4x6 di default). Creare un'etichetta acquista affrancatura dal conto EPS. Un annullamento risponde CANCELED, o DISPUTED con un disputeId quando USPS ha aperto una richiesta di rimborso. usps_get_payment_account legge il conto e, con amount, indica se i fondi sono sufficienti. usps_create_scan_form mette molte etichette su un unico PS Form 5630 per una singola scansione di accettazione. Attiva questi strumenti solo dopo che USPS ha approvato le API delle Etichette e provali prima sull'host di test.

Errori: i fallimenti arrivano come error con code, message e un elenco errors (title, detail, source.parameter). 400 indica il campo errato; 401 significa credenziali errate o token scaduto; 403 significa che l'app non ha quell'API (è al di fuori del prodotto predefinito); 404 significa che USPS non ha trovato nulla, ad esempio un numero di tracciamento sconosciuto.

Limiti: ogni app ha una quota di chiamate per ora; un 429 significa che è esaurita fino alla prossima ora. USPS aumenta la quota su richiesta tramite la pagina Contattaci. Le date sono nel formato YYYY-MM-DD.

Passo 2 — Installa l'adattatore

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

Passo 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
  2. Salva il file e riavvia Cursor.
  3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
  4. Inizia a chattare: l'agente ora può usare i tool di USPS.

Strumenti disponibili

StrumentoCosa fa
usps_validate_addressConvalida e standardizza un indirizzo statunitense. Restituisce address nella forma standard USPS (streetAddress, city, state, ZIPCode, ZIPPlus4)…
usps_get_city_stateCerca la città e lo stato di un codice ZIP a 5 cifre. Restituisce city (in maiuscolo), state (due lettere) e ZIPCode. Chiamata economica, usata come…
usps_get_zip_codeTrova il codice ZIP e il ZIP+4 di un indirizzo stradale in una città e stato. Restituisce address con la strada standardizzata, city, state…
usps_search_domestic_pricesPrezzo di un pacco nazionale attraverso le classi di posta, servizi extra inclusi. Restituisce rateOptions, uno per prodotto idoneo, ciascuno con…
usps_list_domestic_pricesElenca ogni prodotto per cui un pacco nazionale è idoneo, con il suo prezzo base e senza servizi extra. Restituisce rateOptions con…
usps_search_letter_pricesPrezzo di una lettera di First-Class Mail, pacco (busta grande) o cartolina inviata negli Stati Uniti. Restituisce totalBasePrice e rates (SKU…
usps_search_international_pricesPrezzo di un pacco internazionale in uscita, servizi extra inclusi e, su richiesta, dazi e tasse per articolo. Restituisce rateOptions, uno per…
usps_list_international_pricesElenca ogni prodotto internazionale per cui un pacco in uscita è idoneo, con prezzi base e senza servizi extra. Restituisce rateOptions con…
usps_search_international_letter_pricesPrezzo di una lettera di First-Class Mail International, pacco o cartolina. Restituisce totalBasePrice, rates (SKU, description, price, fees)…
usps_get_delivery_estimatesStima la data di consegna della posta accettata in un dato giorno. Restituisce un elenco, un'entrata per classe di posta, con serviceStandard (giorni)…
usps_get_service_standardsOttieni il numero standard di giorni di consegna tra due codici ZIP per classe di posta. Restituisce un elenco con mailClass, days…
usps_get_international_service_standardOttieni il tempo di consegna previsto di una classe di posta internazionale per un paese. Restituisce countryCode, mailClass e…
usps_search_shipping_optionsConfronta ogni modo di spedire un pacco in una sola chiamata: prezzi e impegni di consegna insieme, nazionali o internazionali. Restituisce…
usps_track_packageTraccia un pacco USPS con Tracking 3.2. Restituisce trackingNumber, uniqueTrackingID, mailClass, status, statusCategory (ad es.…
usps_track_packagesTraccia fino a 35 pacchi USPS in una chiamata con Tracking 3.2. Restituisce un risultato per numero con trackingNumber, uniqueTrackingID…
usps_register_tracking_notificationsIscriviti a 3 indirizzi email per email di tracciamento USPS riguardo a un pacco: aggiornamenti sulla consegna prevista, attività di consegna o tutti gli aggiornamenti. Necessita…
usps_request_proof_of_deliveryFai inviare da USPS una lettera di prova di consegna (o una ricevuta di ritorno elettronica) per un pacco consegnato a un massimo di 3 destinatari. Necessita il…
usps_find_post_officesTrova Uffici Postali e altre località di vendita vicino a un codice ZIP, un indirizzo o coordinate, più vicini per primi. Restituisce locations con…
usps_find_dropoff_locationsTrova le strutture di ingresso di destinazione dove puoi consegnare la posta per Parcel Select, USPS Connect e servizi di pacchetti per un codice ZIP di destinazione…
usps_find_parcel_lockersTrova i Parcel Lockers USPS per codice ZIP o per città e stato. Restituisce un elenco di armadietti con facilityID, locationName, locationAddress…
usps_check_pickup_eligibilityControlla se USPS offre il ritiro gratuito del Corriere a un indirizzo. Risponde 200 con pickupAddress in forma standardizzata quando l'indirizzo è…
usps_get_pickupOttieni un ritiro programmato del Corriere con numero di conferma. Restituisce confirmationNumber, pickupDate e carrierPickupRequest (indirizzo…
usps_get_payment_accountControlla un Conto di Pagamento Aziendale o permesso. Restituisce i dettagli del conto e, quando amount è fornito, sufficientFunds (vero o falso)…
usps_create_payment_authorizationOttieni il token di autorizzazione al pagamento di cui ogni chiamata di etichetta ha bisogno: nomina la tua azienda come PAYER e LABEL_OWNER con il suo CRID, Mailer ID e…
usps_create_labelAcquista affrancatura e crea un'etichetta di spedizione nazionale, pagata dal Conto di Pagamento Aziendale nel token di autorizzazione al pagamento. Restituisce…
usps_create_return_labelCrea un'etichetta di ritorno nazionale per un cliente per restituire un pacco (to_address è il tuo indirizzo di ritorno, from_address il cliente).…
usps_cancel_labelAnnulla un'etichetta nazionale non utilizzata o richiedi un rimborso per l'affrancatura. Restituisce trackingNumber, status (CANCELED, o DISPUTED quando una richiesta di rimborso…
usps_create_international_labelAcquista affrancatura e crea un'etichetta internazionale con il suo modulo doganale (First-Class Package International Service, Priority Mail International…
usps_cancel_international_labelAnnulla un'etichetta internazionale non utilizzata o richiedi un rimborso per l'affrancatura. Restituisce il numero di tracciamento, status (CANCELED o DISPUTED) e il…
usps_schedule_pickupPrenota un ritiro gratuito del Corriere USPS per pacchi al tuo indirizzo (da lunedì a sabato; solo per lo stesso giorno fino alle 2 del mattino ora centrale). Restituisce…
usps_cancel_pickupAnnulla un ritiro programmato del Corriere con numero di conferma. Restituisce 200 quando annullato. Installato disattivato: le cancellazioni rimangono con un…
usps_create_scan_formCrea un modulo SCAN (PS Form 5630) che collega le etichette a un codice a barre, in modo che una singola scansione all'accettazione registri ogni pacco. Restituisce…

Esempi di prompt

  • "Dove si trova il pacco USPS 9400111899223197428490?"
  • "È 1600 Pennsylvania Ave NW, Washington DC 20500 un indirizzo valido, e qual è il suo ZIP+4?"
  • "Confronta i prezzi e le date di consegna USPS per una scatola da 3 lb da 10001 a 94105 spedita domani."
  • "Quanto costa un pacco da 2 lb a Toronto con USPS Priority Mail International?"
  • "Trova Uffici Postali aperti sabato vicino al codice ZIP 60614."

FAQ

Da dove provengono le credenziali USPS? Da un'app nel Portale di Onboarding Clienti USPS (cop.usps.com), accedendo con il tuo Account Business USPS: apri Le mie app, aggiungi un'app e copia la sua Chiave del Consumatore e il Segreto del Consumatore. Scegli l'host di produzione o l'Ambiente di Test per Spedizionieri; entrambi richiedono le stesse credenziali.

Cosa funziona subito e cosa necessita dell'approvazione USPS? Indirizzi, prezzi, giorni di consegna, opzioni di spedizione, tracciamento e località funzionano con ogni nuova app. Il Ritiro del Corriere, i pagamenti, le etichette e gli SCAN Forms necessitano dell'approvazione USPS tramite una richiesta di servizio API USPS; le etichette necessitano anche di USPS Ship e di un Conto di Pagamento Aziendale.

Quali strumenti vengono installati disattivati? Gli strumenti che acquistano o prenotano: usps_create_payment_authorization, usps_create_label, usps_create_return_label, usps_cancel_label, usps_create_international_label, usps_cancel_international_label, usps_schedule_pickup, usps_cancel_pickup e usps_create_scan_form. Attivali nella pagina del connettore una volta che USPS li ha approvati e l'AI dovrebbe usarli.

Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

Questa guida ti è stata utile?

Collega USPS a Cursor in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega USPS con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. Senza codice e senza server da gestire.

Guide correlate

Connettori

USPS MCP per ChatGPT: tariffe e tracking

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Connettori

USPS MCP per Claude: tariffe e tracking

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Connettori

USPS MCP per Microsoft Copilot

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Connettori

USPS MCP per Gemini CLI: tariffe di spedizione

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Connettori

USPS MCP per Meta Muse: tariffe di spedizione

API USPS per spedizionieri: convalida indirizzi statunitensi e ricerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.

Connettori

USPS MCP Server: indirizzi, spedizioni e tracking

API USPS per spedizionieri: valida indirizzi statunitensi e cerca codici ZIP, confronta prezzi nazionali e internazionali, ottieni giorni di consegna e opzioni di spedizione, traccia pacchi e trova Uffici Postali, punti di consegna e Parcel Lockers. Etichette, rimborsi, ritiri e SCAN Forms sono inclusi ma disattivati. Chiave e Segreto del consumatore di un'app nel Portale di Onboarding Clienti USPS.