Pipe17 MCP Server

Connects Claude and other Model Context Protocol clients to Pipe17, so you can ask about your orders, shipments, fulfillments, products, inventory, integrations and more in plain language, and make a few changes to orders.

Setup

The server URL is:

https://mcp.pipe17.com/mcp

You sign in with your Pipe17 account. One login reaches every Pipe17 org your account belongs to, and you pick the org in the conversation.

Claude (claude.ai and Claude Desktop)

Add a custom connector with the URL above. When Claude asks you to connect, sign in with your Pipe17 account.

Claude Code

claude mcp add --transport http pipe17 https://mcp.pipe17.com/mcp

Then run /mcp in Claude Code and sign in.

Other MCP clients

Any client that supports the Streamable HTTP transport and OAuth can connect to the URL above.

API keys

A Pipe17 API key works on the per-org URL instead, sent in the x-pipe17-key header:

https://mcp.pipe17.com/mcp/{orgKey}

Replace {orgKey} with the key of the org the API key belongs to. In Pipe17, it's shown at the top of Settings > Profile. The plain /mcp URL accepts sign-ins only.

Tools

43 tools. 4 of them change data: Cancel Order, Create Sales Order, Fulfill Order, Update Order. Every other tool only reads.

ToolAccessWhat it does
Cancel Order
cancel-order
Writes Cancels a whole order: sets its status to canceled and cancels and restocks every open shipment on it. Cancelling individual line items is not supported.
Asks you to confirm first
Create Sales Order
create-sales-order
Writes Creates a new sales order in the system. Automatically initiates fulfillment workflow. Requires external order ID and line items with SKUs, quantities, and prices.
Fulfill Order
fulfill-order
Writes Creates a fulfillment record for an order, indicating items have been shipped. Requires order ID, tracking number, and line items.
Update Order
update-order
Writes Updates an existing order with new information. It can't cancel an order: use cancel-order, which asks the user to confirm first.
Get Automation
get-automation
Reads Get a specific automation by ID.
Get Customer
get-customer
Reads Get a specific customer by ID.
Get Exception
get-exception
Reads Get a specific exception by ID.
Get Fulfillment
get-fulfillment
Reads Get a specific fulfillment by ID.
Get Fulfillments by Order
get-fulfillments-by-order
Reads Retrieve all fulfillments for an order by external order ID
Get Integration
get-integration
Reads Get a specific integration by ID.
Get Location
get-location
Reads Get a specific location by ID.
Get Order
get-order
Reads Get a specific order by ID.
Get Order by External ID
get-order-by-external-id
Reads Retrieve order details by external order ID from other systems (e.g., "ORDER-123", "WOO-456", "SHOP-789")
Get Order Routing
get-order-routing
Reads Get a specific order routing by ID.
Get Product
get-product
Reads Get a specific product by ID.
Get Schema Mapping Context
get-schema-mapping-context
Reads Get the requisite context for explaining a mapping rule including vendor schema, default mapping, and public mapping
Get Schema Mappings
get-schema-mappings
Reads Retrieve schema mappings for an integration
Get Shipments by Order
get-shipments-by-order
Reads Retrieve all shipments for an order by external order ID
Get Shipping Request
get-shipping-request
Reads Get a specific shipping request by ID.
List Automation Rules
list-automation-rules
Reads List automation rules.
List Automation Runs
list-automation-runs
Reads List automation runs.
List Automations
list-automations
Reads List automations.
List Customers
list-customers
Reads List customers.
List Events
list-events
Reads List events.
List Exceptions
list-exceptions
Reads List exceptions.
List Fulfillments
list-fulfillments
Reads List fulfillments.
List Integrations
list-integrations
Reads List integrations.
List Inventory
list-inventory
Reads List inventory.
List Jobs
list-jobs
Reads List jobs.
List Locations
list-locations
Reads List locations.
List Notes
list-notes
Reads List notes.
List Order Routing Runs
list-order-routing-runs
Reads List order routing runs.
List Order Routings
list-order-routings
Reads List order routings.
List Orders
list-orders
Reads List orders.
List Organizations
list-organizations
Reads List the Pipe17 orgs this login can reach, with each org's orgKey, name, accountId and isHoldingOrg.
Only on /mcp
List Products
list-products
Reads List products.
List Shipping Requests
list-shipping-requests
Reads List shipping requests.
Search Customers
get-customers
Reads Retrieves customer information including contact details, addresses, and order history.
Search Fulfillments
get-fulfillments
Reads Retrieves fulfillment records including shipping details, tracking numbers, and delivery status.
Search Inventory
get-inventory
Reads Retrieves inventory levels across warehouses and locations.
Search Orders
get-orders
Reads Retrieves orders details when you need to check order status, view line items, track fulfillment progress, or investigate customer inquiries.
Search Product Variants
get-product-variants
Reads Retrieves product variant information (child products with different sizes, colors, or other attributes).
Search Products
get-products
Reads Retrieves product catalog information including SKUs, names, descriptions, and inventory details.

Permissions

Troubleshooting

Asked to sign in again

Your login expired or was revoked. Reconnect the connector and sign in again.

"Pipe17 didn't accept this login"

Pipe17 refused this account. Reconnect and sign in again. If it keeps happening, ask your Pipe17 admin to check your user.

"needs an orgKey", or the wrong org

Your account reaches more than one org, so name the one you mean, or ask Claude to list your orgs. Tools that change data always need the org named.

"isn't one of the orgs this login can reach"

The account you signed in with isn't a member of that org. Ask Claude to list your orgs, or sign in with another account.

"AI access is turned off", or HTTP 403 "AI access disabled for this organization"

An admin of that org has to turn AI access on.

"different orgs in the last minute"

One login can query a limited number of orgs a minute. Narrow the question to fewer orgs, or wait a minute.

A confirmation expired

Confirmations last 5 minutes. When one expires, Claude gets a new summary; check it and confirm that one.

HTTP 503 "Authorization keys temporarily unavailable"

Pipe17's sign-in service was briefly unreachable, so the server couldn't check your login. Try again in a minute.

Still stuck?

Contact support@pipe17.com or visit the Pipe17 Help Center.