Pipeyard
Log inSign up

ShipBob MCP Connector

ShipBob
logisticsStatus: Active★ 4.6 ratingSecurity score: 9/10Context size: Small

Connect AI agents to ShipBob for ecommerce fulfillment, inventory management, order processing, and warehouse operations.

Back to catalogView API docsView on GitHub

Auth notes

Personal Access Token (PAT) authentication. Generate from ShipBob Dashboard → Integrations → API Tokens → Generate New Token. Pass token as Authorization: Bearer {token} in all request headers. Free sandbox environment available for testing — sign up at developer.shipbob.com. Accounts are free until physical inventory arrives. Note: ShipBob has an official MCP Server documented at developer.shipbob.com/mcp-server.

Rate limits

150 requests per minute using a sliding window, totalled per user per application across all ShipBob API calls. Returns 429 with Retry-After header when limit exceeded. Implement exponential backoff on all 429 responses. Bulk operations recommended for processing large order volumes.

Edge cases

Sandbox environment supports simulations of ShipBob facility actions like shipping and delivering orders — use this thoroughly before production. Order items require exact SKU matches to ShipBob product catalog — mismatched SKUs cause silent failures. Inventory counts update asynchronously after receiving shipments — poll status endpoint for completion. Pagination uses page and pageSize parameters — max 250 records per page.

Sandbox testing

Run test calls against ShipBob from Pipeyard. Try prompts below to see a simulated response; real MCP integration is coming in a future release.

Have a connector you'd like us to prioritize or a specific test flow you care about? Use the Requests page to submit new ideas.

Quick Start — curl example

curl
curl -X GET "https://api.shipbob.com/1_0/order?PageSize=10" \
  -H "Authorization: Bearer {personal_access_token}" \
  -H "shipbob_channel_id: {channel_id}" \
  -H "Content-Type: application/json"

Credential Setup Guide

  1. 11. Go to developer.shipbob.com and sign up for a free developer account
  2. 22. In ShipBob Dashboard go to Integrations then API Tokens
  3. 33. Click Generate New Token and copy it immediately — shown only once
  4. 44. Get your Channel ID by calling GET https://api.shipbob.com/1_0/channel
  5. 55. Include shipbob_channel_id header in every request
  6. 66. Use sandbox at developer.shipbob.com to simulate warehouse actions
  7. 77. Test order creation with sandbox before connecting to live inventory
  8. 88. Official MCP server available at developer.shipbob.com/mcp-server

Example API Response

Sample data
curl
{
  "data": [
    {
      "id": 44921,
      "reference_id": "ORD-2025-44921",
      "status": "Processing",
      "created_date": "2025-03-10T10:00:00Z",
      "recipient": {
        "name": "Alice Johnson",
        "address": {
          "address1": "789 Elm Avenue",
          "city": "Chicago",
          "state": "IL",
          "zip_code": "60601",
          "country": "US"
        }
      },
      "products": [
        {
          "reference_id": "SKU-WIDGET-XL",
          "name": "Premium Widget XL",
          "quantity": 2
        }
      ],
      "shipping_method": "Standard",
      "tracking_number": "1Z999AA10123456784"
    }
  ]
}