usa-logistics
Let AI agents ship in the USA — buy USPS and multi-carrier labels via EasyPost, track packages, refund unused labels.
Что умеет
- Create Shipment: Create a US shipping label via EasyPost — pass a to_address, from_address and parcel (dimensions in INCHES, weight in OUNCES); the server fetches carrier rates (USPS / UPS / FedEx etc
- Query Tracking: Track a US shipment by its tracking_code (the one create_shipment returned, or any USPS/UPS/FedEx tracking number). Returns the current status plus a plain-English hint. Status values
- Refund Label: Request a refund for a US shipping label bought via create_shipment, by shipment_id (preferred) or by tracking_code. Refund is only possible for UNUSED labels — e.g. USPS labels can be r
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Let AI agents ship in the USA — buy USPS and multi-carrier labels via EasyPost, track packages, refund unused labels. Stateless remote MCP server: bring your own key (free test keys buy real USPS test labels), it never stores anything.
Как подключить
Как подключить usa-logistics к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://usa-logistics--wishpool.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить usa-logistics к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://usa-logistics--wishpool.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить usa-logistics к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://usa-logistics--wishpool.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (3)
Технические названия из tools/list. Нужны только разработчикам.
| create_shipment | Create a US shipping label via EasyPost — pass a to_address, from_address and parcel (dimensions in INCHES, weight in OUNCES); the server fetches carrier rates (USPS / UPS / FedEx etc.), buys the CHEAPEST rate by default (or the carrier/service you specify), and returns the shipment_id, tracking_code, printable label_url and the price paid. Bring your own EasyPost API key via header x-easypost-api-key: free TEST keys (prefix EZTK…) buy real USPS test labels end-to-end at no cost (sign up at easypost.com → API Keys); production keys (prefix EZAK…) buy real postage. The key prefix auto-selects the environment. weight (oz) is always required. Owner policy headers gate the label price before any purchase. |
| query_tracking | Track a US shipment by its tracking_code (the one create_shipment returned, or any USPS/UPS/FedEx tracking number). Returns the current status plus a plain-English hint. Status values (EasyPost enum): unknown, pre_transit (label made, not yet picked up), in_transit, out_for_delivery, delivered, available_for_pickup, return_to_sender, failure, cancelled, error. Raw carrier scan details are always included. Passing the carrier speeds detection. Safe to call anytime. |
| refund_label | Request a refund for a US shipping label bought via create_shipment, by shipment_id (preferred) or by tracking_code. Refund is only possible for UNUSED labels — e.g. USPS labels can be refunded within 30 days of creation ONLY IF the parcel was never scanned by USPS; already-shipped labels cannot be refunded. Returns refund_status: submitted (accepted, carrier still processing — most common), refunded (money returned), rejected (not eligible, e.g. already scanned), or not_applicable. Carriers can take up to ~30 days to move submitted → refunded. |