Shippo MCP server

Connect Shippo to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Shippo MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create shipment tool in Shippo
  • Use the get shipping rates tool in Shippo
  • Use the purchase batch labels tool in Shippo
  • Use the track shipment tool in Shippo
  • Use the schedule pickup tool in Shippo
  • Use the request label refund tool in Shippo

Supported Tools

create_shipment

Create Shipment

Create a shipment to get available shipping rates from all connected carriers. Provide sender/recipient addresses and parcel details. Rates are automatically generated and can be used to purchase labels. Supports inline address/parcel objects or existing object IDs.

get_rates

Get Shipping Rates

Retrieve available shipping rates for an existing shipment. Use this to compare carrier options, prices, and estimated delivery times. Returns one provider page; ordering is not guaranteed.

purchase_batch

Purchase Batch Labels

Purchase all labels in an existing batch. The batch must be in VALID status. After purchasing, labels and tracking numbers will be generated for all shipments in the batch.

track_shipment

Track Shipment

Get the current tracking status and full tracking history for a shipment. Provide a carrier token and tracking number. Works for any shipment, including those created outside of Shippo.

schedule_pickup

Schedule Pickup

Schedule a carrier pickup for eligible shipments. Currently supported for USPS and DHL Express. Specify the pickup location, time window, and the transactions (labels) to be picked up.

create_refund

Request Label Refund

Request a refund for an unused shipping label. You must explicitly request refunds — unused labels are not automatically refunded. Provide the transaction (label) ID to refund.

list_parcel_templates

List Parcel Templates

List all user-created parcel templates and optionally carrier-provided parcel templates. Carrier templates include predefined dimensions (e.g. USPS Flat Rate boxes).

create_parcel_template

Create Parcel Template

Create a reusable parcel template with preset dimensions and weight. Useful for standardized packaging. You can base it on a carrier parcel template or define fully custom dimensions.

create_order

Create Order

Load an order into Shippo for shipping management. Orders represent customer purchase requests and can be used to generate shipping rates and labels through the Shippo dashboard or API.

list_addresses

List Addresses

Retrieve a paginated list of all stored addresses. Use this to browse saved addresses for reuse in shipments.

create_customs_declaration

Create Customs Declaration

Create a customs declaration for international shipments. Include customs items describing the contents, their values, and countries of origin. Requirements depend on the carrier, destination and contents.

create_manifest

Create Manifest

Create a manifest (SCAN form) to close out shipping labels for a given day. A manifest is a single-page document with a barcode that carriers can scan to accept all packages at once. Some carriers require daily manifests.

validate_address

Validate Address

Validate an existing address to check for accuracy and prevent failed deliveries. Returns validation results with any suggested corrections.

purchase_label

Purchase Shipping Label

Purchase a shipping label. You can either select a rate from an existing shipment, or create a label in a single call by providing full shipment details along with carrier and service level. Provides a downloadable label when successful and the tracking number. A purchase can charge the connected account; queued status does not mean a label is ready.

create_address

Create Address

Create and optionally validate a shipping address. Addresses are used as sender or recipient in shipments. When validation is enabled, Shippo checks the address for accuracy and provides suggestions.

list_transactions

List Transactions

Retrieve a paginated list of transactions (label purchases). Filter by rate or tracking status. Use this to browse purchased labels and their statuses.

create_batch

Create Batch Labels

Create a batch by copying the details of existing shipments into new batch shipments. Provide a default carrier account and service level, along with the batch shipments. After creation, purchase the batch to generate all labels.

list_carrier_accounts

List Carrier Accounts

Retrieve all connected carrier accounts. Use this to see which carriers are available for rate shopping and label creation. Filter by carrier name to find specific accounts.

get_shipment

Get Shipment

Retrieve details of a specific shipment by ID, including its addresses, parcels, and status. Also useful for checking if rates are ready for async shipments.

list_orders

List Orders

Retrieve a paginated list of all orders in your Shippo account. Use this to browse orders for shipping management.

get_transaction

Get Transaction

Retrieve details of a specific transaction (label purchase) by ID. Returns label URL, tracking number, and current status. Useful for checking async label generation or retrieving label URLs.

register_tracking

Register Tracking Webhook

Register a tracking number for webhook-based updates. Once registered, Shippo will send tracking status changes to your configured webhook endpoint. You must have a tracking webhook configured before calling this.

get_current_context

Get Current Shipping Context

Verify read-only access and report authentication mode and known API-token test state. This connection does not expose a verified user or account identity.

download_document

Download Shipping Document

Download an existing transaction label or commercial invoice, manifest document, or merged batch label file. This tool does not buy a label or create a manifest.

get_shipping_resource

Get Shipping Resource

Retrieve an existing order, refund, manifest or batch by exact ID. Inspect asynchronous status and batch validation/purchase results before taking another action.

Connect Shippo to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Shippo in Metorial. In your Metorial portal, enable the Shippo MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Shippo tools.

Run Shippo through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Shippo and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Shippo tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Shippo

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Apaleo

Manage hotel and serviced apartment operations through a cloud-based property management system (PMS). Create, modify, cancel, and manage reservations and bookings, including check-in, check-out, no-show handling, and room assignments. Manage property inventory including units (rooms), unit groups (room types), and unit attributes. Set up and update rate plans, rates, restrictions, and availability in real-time. Handle guest folios by posting charges, payments, refunds, and allowances, and move items between folios. Create, cancel, and render invoices as PDFs. Process payments via terminals and pay-by-link, manage payment authorizations, and track transaction lifecycles including settlements, refunds, and disputes. Manage company profiles for corporate bookings. Handle group bookings and room blocks with confirmation, release, and wash operations. Subscribe to ARI (Availability, Rates, Inventory) change notifications for channel distribution. Configure property settings, services, and city taxes. Trigger night audit operations. Manage account users. Retrieve reports and accounting transaction data.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Shopify

Manage e-commerce stores including products, orders, customers, inventory, and fulfillment. Create and update products with variants, images, and metafields. Process and track orders, draft orders, refunds, and transactions. Manage customer records, addresses, and marketing consent. Track and adjust inventory levels across multiple locations. Handle fulfillment workflows including routing to warehouses and third-party logistics. Create and manage discount codes, price rules, and automatic discounts. Configure shipping rates, carrier services, and delivery profiles. Build custom storefronts with cart management and checkout via the Storefront API. Manage content including pages, blogs, articles, and themes. Support B2B commerce with company profiles, catalogs, and custom pricing. Receive webhooks for events across orders, products, customers, inventory, fulfillment, collections, carts, checkouts, disputes, and more.

Technical notes for Shippo

Compare connected carrier rates, create shipments and shipping labels, and track packages. Validate addresses, prepare customs declarations and orders, discover carrier accounts, manage parcel templates, inspect asynchronous batch/refund/manifest status, and download available shipping documents. Label purchases can charge the connected account; carrier eligibility and test-mode restrictions apply.

Frequently asked questions

Common questions about connecting Shippo to AI agents with Metorial.

  1. How many tools does the Shippo MCP server have?
    The Shippo MCP server exposes 25 tools, including Create Shipment, Get Shipping Rates, Purchase Batch Labels. Each one is governed and traced through Metorial.
  2. Shippo exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Shippo MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Shippo and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Shippo MCP server yourself or use the hosted gateway.

Connect Shippo to production AI agents

See how Metorial gives your team governed access to Shippo, with tracing and security controls built in.