Tools

AI Integrations (MCP)

Connect AI assistants like Claude and ChatGPT to your 3PLGuys warehouse account using the Model Context Protocol (MCP). Manage inventory, create shipments, check stock levels, and more — all through natural language.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external services securely. Instead of copy-pasting data between your warehouse dashboard and an AI chat, MCP gives the AI direct, authenticated access to your 3PLGuys account.

Your AI assistant can then read your inventory, create shipments, check invoices, and perform other operations on your behalf — with the same permissions as your API credentials.

MCP Server

MCP Endpoint

https://mcp.3plguys.com/mcp

This is the URL you'll use when adding 3PLGuys as a connector in your AI assistant. Authentication is handled automatically via OAuth — you'll be redirected to log in with your 3PLGuys account.

Setup Guides

Claude (claude.ai)

1.Open Settings and go to Connectors
2.Click Add connector
3.Enter a name (e.g. "3PLGuys")
4.Set the URL to https://mcp.3plguys.com/mcp
5.Leave Client ID and Client Secret empty — they're provided automatically
6.Click Save, then Connect
7.Log in with your 3PLGuys account when prompted

ChatGPT (chatgpt.com)

1.Open Settings and go to Connected apps
2.Click Add connection
3.Enter the URL: https://mcp.3plguys.com/mcp
4.Click Connect
5.Log in with your 3PLGuys account when prompted

Works with any MCP-compatible client

Any AI assistant or tool that supports the Model Context Protocol can connect to 3PLGuys. Use the endpoint URL above and follow your client's MCP setup instructions.

Available Tools

Once connected, your AI assistant has access to 46 tools covering the full 3PLGuys API. You don't need to learn the API — just describe what you need in plain language.

Inventory

List, create, update, delete, and restore products
Manage carton types, contents, dimensions, and weight
Check stock levels by product or carton per warehouse
View warehouse locations and details

Pick & Pack Shipments

Create and delete draft shipments
Set and read shipping address, items, and notes
Submit for fulfillment
Request cancellation of pending shipments

SPD Shipments

Create, delete, and cancel small parcel deliveries
Upload and remove shipping labels and FNSKU labels
Upload and remove custom attachments
Set and read items and notes
Submit with automatic inventory deduction

General Shipments

List shipments across all types with status filters
Get full details of any shipment by ID

Billing & Activity

View invoices and line items
Check notifications and action items
Get AI-powered operational recommendations
View organization account details

Example Use Cases

Here are some things you can ask your AI assistant to do once connected:

Order Fulfillment

"Create a pick & pack shipment for 50 units of SKU-1234 to John Smith at 123 Main St, New York, NY 10001"

The AI creates the draft, sets the address, adds the items, and submits it — all in one conversation.

Stock Monitoring

"Which products are running low on stock? Show me anything under 100 units."

The AI checks stock levels across all warehouses and flags items that need reordering.

Shipment Tracking

"Show me all pending shipments and their details"

Get a summary of active shipments, their status, and shipping addresses without opening the dashboard.

Billing Review

"Show me my recent invoices and break down the charges"

The AI pulls your invoices and explains line items in plain language.

Bulk Operations

"Create SPD shipments for these 10 orders from my spreadsheet"

Paste data directly into chat and the AI creates multiple shipments, sets items, uploads labels, and submits them.

How Authentication Works

The MCP server uses OAuth 2.0 to authenticate with your 3PLGuys account. Here's the flow:

1Your AI client connects to mcp.3plguys.com and discovers it requires authentication
2The client automatically registers and receives a client ID (no setup needed)
3You're redirected to the 3PLGuys login page to sign in with your account
4After login, the AI client receives an access token and can make API calls on your behalf
5Tokens refresh automatically — you only need to log in once

Security

The MCP server never stores your password. It uses OAuth tokens scoped to your account permissions. You can revoke access at any time from your 3PLGuys dashboard. All connections use HTTPS with PKCE for additional security.

Permission Scopes

The MCP connection requests the following scopes. All scopes are granted by default when you log in.

Scope	Access
`inventory`	Products, cartons, stock levels
`shipments`	Create, update, submit, and cancel shipments
`locations`	Warehouse locations and details
`invoices`	Billing and invoice data
`notifications`	Action items and alerts
`recommendations`	AI-powered operational suggestions
`user-account`	Organization account and profile details

Troubleshooting

Authentication keeps failing

Remove the connector, clear any cached client ID or secret, and re-add it with just the URL. Leave client ID and secret empty — they're provided automatically via dynamic registration.

Tools not showing up

Make sure you've completed the login flow. If tools disappear mid-conversation, start a new chat — some clients need a fresh connection.

Permission denied (403)

Your account may not have access to the requested resource. Check that your 3PLGuys account has the necessary permissions for the operation you're trying to perform.