Shippo
Shipping API for e-commerce merchants to create labels, track packages, and manage shipping operations.
Verdict
Common use cases
- Compare carrier rates before buying labels
- Generate return labels during support chats
- Track delayed shipments from Slack threads
- Bulk-create labels for daily order batches
- Prep customs forms for international orders
Integration
- Vendor
- Shippo
- Category
- other
- Auth
- API_KEY
- Tools
- 50
- Composio slug
shippo
Tools
- Create Batch
Tool to create a batch of shipments for bulk label purchasing. Use when you need to process multiple shipments at once with the same carrier and service level. Requires a valid carrier account ID from your Shippo account.
- Create Carrier Account
Tool to create a new carrier account in Shippo. Use when you need to register carrier credentials for shipping operations. This action requires detailed billing and contact information, and for UPS accounts specifically, the user must agree
- Create Customs Item
Create a new customs item for international shipments. Customs items are required for customs declarations when shipping internationally. Use this action to define the contents, value, and origin of items being shipped across international
- Create Live Rate
Tool to generate live shipping rates from multiple carriers for a given shipment. Use when you need real-time pricing for shipping from origin to destination with specific items. Returns available rates with costs and delivery estimates.
- Create Manifest
Tool to create a new shipping manifest with Shippo. Use when you need to generate a manifest document for a carrier with multiple shipments that need to be scanned at pickup.
- Create Merchant Address
Tool to create a new address for a merchant using Shippo's Platform API. Use when you need to add an address to a merchant's account for shipping operations. This endpoint is part of the Platform API and requires a merchant ID.
- Create Merchant Batch
Tool to create a batch for a merchant using the Shippo Platform API. Use when you need to create bulk shipment batches for a specific merchant account. Requires valid merchant ID, carrier account, and shipment IDs.
- Create Merchant Carrier Account
Tool to create a carrier account for a merchant using the Shippo Platform API. Use when you need to register carrier credentials for a specific merchant in a platform integration scenario.
- Create Merchant Customs Declaration
Tool to create a new customs declaration for a merchant using Shippo's Platform API. Use when you need to create a customs declaration for international shipments on behalf of a merchant. This endpoint is part of the Platform API and requir
- Create Merchant Customs Item
Tool to create a new customs item for a merchant using Shippo's Platform API. Use when you need to create customs items for a merchant's international shipments. This endpoint is part of the Platform API and requires a merchant ID.
- Create Merchant Order
Tool to create an order for a merchant using the Shippo Platform API. Use when you need to create an order on behalf of a merchant account with recipient address and order details.
- Create Merchant Parcel
Tool to create a new parcel for a merchant using Shippo's Platform API. Use when you need to define package dimensions for a merchant's shipping operations. This endpoint is part of the Platform API and requires a merchant ID.
- Create Merchant Refund
Tool to create a refund for a merchant using the Shippo Platform API. Use when you need to refund a transaction for a specific merchant account. Requires valid merchant ID and transaction ID.
- Create Merchant Shipment
Tool to create a new shipment for a merchant using Shippo's Platform API. Use when you need to create a shipment with origin/destination addresses and parcel details to get shipping rates. This endpoint is part of the Platform API and requi
- Create Merchant Transaction
Tool to create a shipping label transaction for a merchant using the Shippo Platform API. Use when you need to purchase a shipping label for a specific merchant account using an existing rate ID.
- Create Order
Tool to create a new order in Shippo. Use when you need to register an order for shipment processing. The order must include a recipient address and placement timestamp. Line items can be provided for detailed tracking, or a total weight ca
- Create Parcel
Tool to create a new parcel in Shippo with dimensions and weight specifications. Use when you need to define package dimensions for shipping rate calculations or label generation. The parcel object is required to create shipments and obtain
- Create Refund
Tool to create a refund for a Shippo transaction. Use when you need to refund a previously created shipping label or transaction.
- Create Service Group
Tool to create a new Shippo service group with specified pricing model and carrier service levels. Use when you need to configure a custom shipping rate group for checkout display.
- Create Shipment
Tool to create a new shipment with Shippo. Use when you need to generate shipping rates for a package by providing origin and destination addresses and parcel details.
- Create Shippo Address
Tool to create a new address in Shippo. Use when you need to store sender or recipient addresses for shipping labels and transactions. Addresses can be validated against carrier databases before creation by setting validate=true.
- Create Shippo Webhook
Tool to create a new webhook subscription in Shippo. Use when you need to register an endpoint to receive real-time notifications for shipping events such as tracking updates, transaction creation, or batch processing. Webhooks enable autom
- Create Transaction
Tool to create a shipping label transaction with Shippo. Use when you need to purchase a shipping label either from an existing rate ID or by specifying shipment details directly.
- Create User Parcel Template
Tool to create a new user parcel template in Shippo with preset dimensions and weight specifications. Use when you need to define reusable package configurations for shipping rate calculations or label generation. User parcel templates can
- Delete Default Parcel Templatedestructive
Tool to clear the current default parcel template. Use when you need to remove the default parcel template configuration for live rates at checkout.
- Delete User Parcel Templatedestructive
Tool to delete a user-created parcel template. Use when you need to remove a custom parcel template that is no longer needed.
- Delete Webhookdestructive
Tool to delete a specific webhook from Shippo. Use when you need to remove a webhook that is no longer needed or needs to be reconfigured.
- Get Address
Tool to retrieve a previously created address from Shippo. Use when you need to get the details of an existing address using its object ID.
- Get Carrier Account
Tool to retrieve a carrier account by its ID. Use when you need to get details about a specific carrier account configuration.
- Get Carrier Parcel Template
Tool to retrieve a specific carrier parcel template by its token. Use when you need to get detailed dimensions and specifications for a standardized carrier package type.
- Get Carrier Registration Status
Tool to retrieve carrier registration status from Shippo. Use when you need to check the registration or authentication status of a carrier account.
- Get Customs Declaration
Tool to retrieve a customs declaration by its ID. Use when you need to fetch details about a specific customs declaration including items, certifications, and shipping information.
- Get customs item
Tool to retrieve a customs item from Shippo. Use when you need to fetch details about a previously created customs declaration for international shipments.
- Get Default Parcel Template
Tool to retrieve the current default parcel template for live rates at checkout. Use when you need to view the default parcel dimensions and weight settings.
- Get Merchant
Tool to retrieve a merchant from the Shippo Platform API. Use when you need to get the details of an existing merchant using their object ID.
- Get Merchant Address
Tool to retrieve a merchant address from Shippo Platform API. Use when you need to get the details of an existing merchant address using merchant ID and address ID.
- Get Merchant Batch
Tool to retrieve a batch for a merchant from the Shippo Platform API. Use when you need to get details of an existing batch using merchant and batch IDs.
- Get Merchant Carrier Account
Tool to retrieve a carrier account for a merchant using the Shippo Platform API. Use when you need to get details about a specific carrier account associated with a merchant on the platform.
- Get Merchant Carrier Registration Status
Tool to retrieve carrier registration status for a specific merchant using Shippo's Platform API. Use when you need to check if a merchant has registered or connected a carrier account.
- Get Merchant Customs Declaration
Tool to retrieve a specific customs declaration for a merchant using Shippo's Platform API. Use when you need to fetch details about a merchant's customs declaration for international shipments.
- Get Merchant Customs Item
Tool to retrieve a customs item for a merchant using the Shippo Platform API. Use when you need to fetch details about a specific customs item for a merchant's international shipments.
- Get Merchant Manifest
Tool to retrieve a manifest for a merchant from the Shippo Platform API. Use when you need to get details of an existing manifest using merchant and manifest IDs.
- Get Merchant Order
Tool to retrieve an order for a merchant from the Shippo Platform API. Use when you need to get details of an existing order using merchant and order IDs.
- Get Merchant Parcel
Tool to retrieve a parcel for a merchant from the Shippo Platform API. Use when you need to fetch details of a parcel that belongs to a specific merchant.
- Get Merchant Rate
Tool to retrieve a specific shipping rate for a merchant using the Shippo Platform API. Use when you need to fetch detailed rate information for a merchant's shipment, including pricing, carrier details, and service level.
- Get Merchant Refund
Tool to retrieve a merchant refund from Shippo Platform API. Use when you need to get the details or status of a specific refund for a merchant.
- Get Merchant Shipment
Tool to retrieve a shipment for a merchant from the Shippo Platform API. Use when you need to fetch details of a shipment that belongs to a specific merchant.
- Get Merchant Tracking Status
Tool to retrieve tracking status for a merchant from Shippo Platform API. Use when you need to get the current status, location, and history of a package for a specific merchant using carrier and tracking number.
- Get Merchant Transaction
Tool to retrieve a shipping label transaction for a merchant from the Shippo Platform API. Use when you need to get the details of an existing transaction for a merchant including tracking information, label URLs, and transaction status.
- Register Tracking Webhook
Tool to register a tracking webhook for a shipment. Use when you need to start tracking a shipment using its carrier and tracking number. This creates a tracking object that will receive updates about the shipment's status and location.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Browse MCP Servers. 2. Search for Shippo and click Connect. 3. You'll be prompted to paste your Shippo API key — grab it from your Shippo dashboard under Settings > API. 4. Choose whether to use the live or test environment (test mode is safer for initial setup). 5. Click Authorize to complete the connection. 6. Open any Space and type '@Shippo get live rates' followed by origin and destination addresses to confirm the integration works. 7. If rates appear, you're ready to invoke any of Shippo's 50 tools — label creation, tracking lookups, customs declarations — by @mentioning Shippo and describing what you need.
What teammates see: by default, memories from Shippo are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Compare Shipping Rates
@Shippo get live rates from 123 Main St, San Francisco CA 94103 to 456 Oak Ave, Austin TX 78701 for a 2 lb package, 10x8x6 inchesOpen in a Space →
Buy a Shipping Label
@Shippo create a shipping label with USPS Priority Mail from our warehouse at 789 Industrial Blvd, Portland OR 97201 to customer at 321 Elm St, Seattle WA 98101, package is 3 lbsOpen in a Space →
Track a Shipment
@Shippo track shipment 1Z999AA10123456784 and tell me the latest scan event and expected delivery dateOpen in a Space →
Create Customs Declaration
@Shippo create a customs item for 5 cotton t-shirts, total value $75 USD, country of origin USA, HS tariff code 6109.10.0012Open in a Space →
Validate an Address
@Shippo validate this address: 1600 Amphitheatre Parkway, Mountain View CA 94043 and confirm it's a valid delivery locationOpen in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Shippo get live rates for shipping a 5lb package from our SF warehouse (94103) to a customer in Brooklyn (11201)
Here are the available shipping rates for your 5lb package from San Francisco to Brooklyn: • USPS Priority Mail: $12.45 (2-3 days) • USPS Ground Advantage: $8.99 (2-5 days) • UPS Ground: $15.32 (4-5 days) • FedEx Ground: $16.78 (5 days) All rates include tracking. USPS Priority Mail offers the best balance of speed and cost for this route. Would you like me to create a label with any of these options?
This example shows real-time rate shopping across carriers. Requires at least one active carrier account configured in Shippo. Rates reflect current carrier pricing and may vary by package dimensions, declared value, and delivery address validation. Rate requests count toward your Shippo API quota.
@Shippo create a batch of 25 labels for our daily orders using USPS Priority Mail, all shipping from warehouse address on file
Batch created successfully (batch_f3a8b2c1d4e5). Processing 25 shipments with USPS Priority Mail: • 23 labels generated successfully • 2 failed due to invalid destination addresses Total cost: $287.35. Labels are ready for download as a combined PDF. Failed shipments flagged for address correction. Batch will remain accessible for 30 days for reprints or refunds.
Batch creation streamlines high-volume label purchasing but requires all shipments to use the same carrier and service level. Failed labels in a batch still consume API calls. You'll need a valid USPS carrier account with sufficient postage balance. Review address validation errors before retrying failed shipments.
@Shippo review our last 50 international shipments and flag any that are missing required customs declarations
Analyzed 50 international shipments from the past 14 days: • 47 shipments have complete customs declarations • 3 shipments missing customs items: - Order #8821 to Canada (created Dec 18) - Order #8856 to UK (created Dec 19) - Order #8903 to Australia (created Dec 20) All three are pending label purchase. Each needs customs item details (description, value, origin country, HS code) before labels can be generated. International shipments without customs data will be rejected by carriers.
This synthesis example combines shipment retrieval with AI reasoning to audit compliance. Customs requirements vary by destination country—Canada has simpler rules than EU destinations. Missing customs declarations block label purchase entirely. The MCP provides shipment data; the AI identifies the compliance gaps.
Use-case deep-dives
When Shippo wins for mid-volume DTC shipping
A 6-person DTC brand shipping 80 orders daily from a single warehouse hits the sweet spot for Shippo's MCP. The Create Batch tool lets your ops lead queue morning shipments in Switchy, pull live rates across USPS/UPS/FedEx with one prompt, then generate labels in bulk before the 2pm pickup. The 50-tool surface looks heavy, but you'll use five: Create Live Rate, Create Batch, Create Customs Item (if you ship internationally), Create Manifest, and the occasional Create Carrier Account when you add a new service. If you're under 20 orders/day, the API_KEY setup is overkill—just use Shippo's dashboard. If you're over 500/day, you need a dedicated fulfillment system with webhooks, not an MCP. For the mid-volume band, this is the fastest way to let non-technical teammates comp shipping costs and print labels without leaving the chat.
When the Platform API tools justify the complexity
A 4-person team running a Shopify-style marketplace with 12 independent sellers needs the Create Merchant Carrier Account and Create Merchant Batch tools—these are the only reason to use Shippo's MCP over a simpler shipping integration. Each seller brings their own UPS account; your ops person uses Switchy to register those credentials, assign them to the right merchant ID, then batch their labels separately for end-of-day manifests. The workflow is clunky (you're managing 50 tools when you need 8), but no other MCP exposes Shippo's Platform API, so if you're aggregating shipping for multiple entities under one roof, this is the play. If you're a single-entity shop, skip this—the merchant-scoped tools are dead weight. If you're over 50 merchants, you need a real middleware layer, not an MCP.
When Create Live Rate beats a shipping calculator
A 3-person support team at a B2B parts supplier fields 15-20 'how much to ship this to Ohio' questions daily. The Create Live Rate tool turns Switchy into a live shipping calculator: the rep pastes the customer's address, describes the part (weight, dimensions), and gets back carrier options with real prices in 4 seconds. No tab-switching to Shippo's dashboard, no manual entry errors, no stale rate cards. The catch: this only works if your team already uses Shippo for fulfillment and has carrier accounts configured. If you're quoting rates for a shipping method you don't actually use, the MCP will return nothing—Shippo only prices routes you can fulfill. For teams doing 10+ quotes/day on existing carrier relationships, this is faster than any dashboard. For occasional quotes or hypothetical scenarios, just use Shippo's web UI.
Frequently asked
What does the Shippo MCP let me do in Switchy?
The Shippo MCP connects your Switchy workspace to Shippo's shipping API. You can generate live carrier rates, create shipping labels in bulk, manage carrier accounts, and handle customs documentation for international shipments. It's built for teams that ship physical products and want to automate label creation, rate shopping, and manifest generation without leaving Switchy.
Do I need a Shippo API key to use this MCP?
Yes. The Shippo MCP uses API key authentication, so you'll need an active Shippo account and a valid API key from your Shippo dashboard. Paste the key into Switchy's connection flow. If your team uses multiple Shippo accounts (say, one per brand), each account needs its own API key and separate MCP connection in Switchy.
Can the Shippo MCP track shipments after I create a label?
No. The MCP focuses on pre-shipment tasks: generating rates, buying labels, creating batches, and building manifests. Shippo's API does support tracking, but this MCP doesn't expose those tools yet. If you need tracking updates in Switchy, you'll need to pull that data directly from Shippo's dashboard or use a webhook integration outside the MCP.
Why use this MCP instead of Shippo's web dashboard?
The MCP is faster for repetitive tasks and bulk operations. If you're creating 50 labels with the same carrier settings, you can script it in Switchy instead of clicking through Shippo's UI 50 times. It also lets you chain shipping logic with other MCPs—like pulling order data from Shopify, generating labels via Shippo, then logging the tracking numbers in Notion.
Who on my team should connect the Shippo MCP?
Whoever manages your Shippo account and has access to the API key. This is usually your ops lead or the person who handles shipping integrations. Once connected, any Switchy user in your workspace can use the MCP to create labels or check rates, but only the person with the API key can update carrier accounts or billing settings.