> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goshippo.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Shippo is a multi-carrier shipping API. For agent integrations that execute shipping operations (rates, labels, tracking, address validation, customs), connect the hosted Shippo MCP server at https://mcp.shippo.com (per-user OAuth; setup at /guides/mcp-server). To search and read this documentation from an agent, a docs search MCP is available at https://docs.goshippo.com/mcp. Shipping workflow knowledge (agent skills and a knowledge pack) is published at https://github.com/goshippo/ai. For REST integrations start at /guides/api-quickstart; test mode uses shippo_test_ API keys.

# Additional resources

> Live account and charges, security, troubleshooting, and support for the hosted Shippo MCP server.

## Live account and charges

The hosted MCP server authorizes your **live** Shippo account, so:

* **Read operations are free:** comparing rates and validating addresses do not charge your account, and tracking packages purchased through Shippo is free too. Tracking a package purchased *outside* Shippo is a billable action.
* **Buying a label is a live action** that charges your account. Write actions such as purchasing a label ask for confirmation before they run.

The hosted MCP server has no separate test mode. If you need test labels and mock tracking for development, use a test API key (`shippo_test_`) directly against the Shippo API, see [Testing the Shippo API](/guides/testing). Test and live data (and object IDs) are completely separate.

## Security

Requests are sent to Shippo's hosted MCP server over HTTPS, authenticated by your per-user Shippo authorization, and forwarded to the Shippo API on your behalf. There is no API key to store and no local process in the path. To disconnect, remove the Shippo connector from your client's settings and revoke access from your Shippo account if desired.

## Troubleshooting

* **Shippo isn't in your directory:** the listing may still be rolling out to your client, or your workspace limits directory connectors. Add it as a custom connector with the URL `https://mcp.shippo.com` (see the [Claude or ChatGPT steps](/guides/mcp-server-setup)).
* **Shippo doesn't appear in the connector or tool picker:** confirm the server was added and the Shippo sign-in completed. Reopen your client's connector settings to check its status.
* **You're asked to sign in again:** the authorization session expired. Re-authorize from the connector settings (in Claude Code, run `/mcp`).
* **The sign-in window is blocked:** allow pop-ups for your client and retry.

## Resources

* [Shippo API Documentation](/)
* [Quickstart Guide](/guides/api-quickstart)
* [Authentication](/guides/authentication)
* [MCP Protocol Specification](https://modelcontextprotocol.io/)

## Support

For questions or issues:

* [Shippo Support Portal](https://support.goshippo.com/)
* [API Status](https://status.goshippo.com/)
* [Contact Sales](https://goshippo.com/contact/)


## Related topics

- [MCP Server](/guides/mcp-server.md)
- [API Reference Overview](/api-reference/overview.md)
- [Where to Get Information](/partner-integration/get-info.md)