W3Ship/w3ship-mcp-server

W3Ship/w3ship-mcp-server

от baskcart
W3Ship Commerce MCP Server даёт AI-агентам (Claude, Cursor) создавать корзины, заказы, отслеживать доставку, торговать P2P, обменивать токены (Uniswap) и раздавать промо — всё с криптоидентификацие...

W3Ship Commerce MCP Server

Let AI shop for you — with no passwords, no logins, just cryptographic identity.

W3Ship is the first MCP (Model Context Protocol) server for AI-powered commerce. It gives AI agents like Claude, Cursor, and VS Code Copilot the ability to create shopping carts, place orders, track shipments, book sessions, swap tokens via Uniswap, sell items P2P, and distribute promotional items with in-store pickup — all using cryptographic identity (SLH-DSA / ECDSA) instead of passwords.

Built on TMF Open API standards (TMF663, TMF622, TMF621) for interoperability.


⚡ Quick Start

Install via npx (recommended)

No installation required — just configure your AI client:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "w3ship": {
      "command": "npx",
      "args": ["-y", "w3ship-mcp-server"],
      "env": {
        "VALKEY_HOST": "localhost",
        "VALKEY_PORT": "6379"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

add_item

Добавляет товар в существующую корзину. Использует W3SHIP_PUBLIC_KEY в качестве cartId, если он не указан.

Добавляет товар в существующую корзину. Использует W3SHIP_PUBLIC_KEY в качестве cartId, если он не указан.

Параметры

  • cartIdstringобязательный

    Public key ID of the cart. Optional if W3SHIP_PUBLIC_KEY is set.

  • itemobjectобязательный
add_tracking

Инструмент продавца: Добавить реальную информацию об отслеживании доставки к заказу после отправки товара. Предоставляет покупателю трек-номер и название перевозчика.

Инструмент продавца: Добавить реальную информацию об отслеживании доставки к заказу после отправки товара. Предоставляет покупателю трек-номер и название перевозчика.

Параметры

  • orderIdstringобязательный

    The order ID

  • carrierstringобязательный

    Shipping carrier: UPS, FedEx, USPS, DHL, etc.

  • trackingNumberstringобязательный

    Carrier tracking number

  • sellerAddressstring

    Seller wallet address (for verification). Uses W3SHIP_PUBLIC_KEY if not provided.

check_token_approval

Проверяет, разрешён ли токен для обмена на Uniswap. Возвращает, требуется ли одобрение, и транзакцию одобрения, если да. Требует переменную окружения UNISWAP_API_KEY.

Проверяет, разрешён ли токен для обмена на Uniswap. Возвращает, требуется ли одобрение, и транзакцию одобрения, если да. Требует переменную окружения UNISWAP_API_KEY.

Параметры

  • tokenstringобязательный

    Token symbol (USDC, USDT, DAI, WETH) or contract address

  • amountstringобязательный

    Amount to approve (in human-readable units)

  • walletAddressstring

    Wallet address. Uses W3SHIP_PUBLIC_KEY if not provided.

  • chainIdnumber

    Chain ID (default: 8453 for Base)

claim_promo

Получите БЕСПЛАТНОЕ промо-объявление. Товары стоят $0. Для акций с доставкой вы платите только за доставку; для акций с самовывозом всё полностью бесплатно. Одна заявка на один кошелек. Необходимо иметь зарегистрированную учётную запись W3Ship/Dah.mx (для доставки требуется адрес, для самовывоза достаточно кошелька).

Получите БЕСПЛАТНОЕ промо-объявление. Товары стоят $0. Для акций с доставкой вы платите только за доставку; для акций с самовывозом всё полностью бесплатно. Одна заявка на один кошелек. Необходимо иметь зарегистрированную учётную запись W3Ship/Dah.mx (для доставки требуется адрес, для самовывоза достаточно кошелька).

Параметры

  • listingIdstringобязательный

    The promotional listing ID to claim

  • publicKeystring

    Your public key / wallet address for identity verification. Uses W3SHIP_PUBLIC_KEY if not provided.

  • fulfillmentChoicestring

    How to receive the item: "ship" (mailed to your address — may have shipping cost) or "pickup" (free, collect at pickup location). Defaults based on listing configuration.

  • pickupLocationIdstring

    ID of the pickup location (required when multiple pickup locations exist and fulfillmentChoice is "pickup")

confirm_payment

Отправьте on-chain платежную транзакцию для верификации. После оплаты продавцу (отправьте криптовалюту на его адрес кошелька), предоставьте здесь хэш транзакции, чтобы подтвердить оплату и обновить статус заказа до "paid".

Отправьте on-chain платежную транзакцию для верификации. После оплаты продавцу (отправьте криптовалюту на его адрес кошелька), предоставьте здесь хэш транзакции, чтобы подтвердить оплату и обновить статус заказа до "paid".

Параметры

  • orderIdstringобязательный

    The order ID to confirm payment for

  • txHashstringобязательный

    The on-chain transaction hash (0x...)

  • chainIdnumber

    Chain ID where payment was sent. Default: 8453 (Base)

create_cart

Создать новую корзину покупок TMF663. Если настроен W3SHIP_PUBLIC_KEY, он используется автоматически - идентификатор не требуется. В противном случае укажите открытый ключ SLH-DSA или ECDSA (в hex).

Создать новую корзину покупок TMF663. Если настроен W3SHIP_PUBLIC_KEY, он используется автоматически - идентификатор не требуется. В противном случае укажите открытый ключ SLH-DSA или ECDSA (в hex).

Параметры

  • idstring

    Public key (hex). Optional if W3SHIP_PUBLIC_KEY env var is set.

  • customerobject
create_listing

Создайте объявление P2P-маркетплейса. Любой может продавать товары - регистрация продавца не требуется. Укажите название, цену, валюту (USDC/ETH/etc) и адрес вашего кошелька для оплаты.

Создайте объявление P2P-маркетплейса. Любой может продавать товары - регистрация продавца не требуется. Укажите название, цену, валюту (USDC/ETH/etc) и адрес вашего кошелька для оплаты.

Параметры

  • titlestringобязательный

    Item title (e.g. "PS5 Console")

  • descriptionstringобязательный

    Item description

  • pricenumberобязательный

    Price amount (e.g. 200). Set to 0 for promotional items.

  • currencystring

    Payment currency (USDC, ETH, DAI, etc). Default: USDC

  • categorystring

    Category: electronics, clothing, collectibles, home, sports, gifts, books, promotional, other

  • sellerAddressstring

    Seller wallet address for payment. Uses W3SHIP_PUBLIC_KEY if not provided.

  • sellerNamestring

    Optional display name for the seller

  • conditionstring

    Item condition: new, like_new, used, refurbished. Default: new

  • quantitynumber

    How many available. Default: 1

  • shipsTostring[]

    Countries that can be shipped to (e.g. ["US", "CA"]). Default: ["US"]

  • expiresInDaysnumber

    Listing expires after N days. Default: 30

  • isPromoboolean

    Set to true for promotional/free items. Price auto-sets to 0, category to "promotional".

  • shippingCostnumber

    For promo items: shipping cost the buyer pays (e.g. 8.99). Default: 0

  • promoQuantitynumber

    For promo items: how many are available to claim (e.g. 500). Default: 100

  • fulfillmentTypestring

    Fulfillment method: "ship" (mail only), "pickup" (in-store only), "both" (customer chooses). Default: "ship". Set to "pickup" for zero-cost promo distribution.

  • pickupLocationsobject[]

    Pickup locations for in-store fulfillment. Required when fulfillmentType is "pickup" or "both".

create_order

Преобразовать корзину покупок в подтвержденный заказ (TMF622) и запустить выполнение.

Преобразовать корзину покупок в подтвержденный заказ (TMF622) и запустить выполнение.

Параметры

  • cartIdstringобязательный

    The ID of the shopping cart to convert

delete_cart

Удалите корзину покупок.

Удалите корзину покупок.

Параметры

  • idstringобязательный

    Public key ID of the cart

generate_demo_key

Генерирует пару ключей ECDSA для тестирования. Возвращает публичный ключ в hex, который можно использовать с create_cart и другими инструментами. Пригодится для проверки торгового потока без реального кошелька.

Генерирует пару ключей ECDSA для тестирования. Возвращает публичный ключ в hex, который можно использовать с create_cart и другими инструментами. Пригодится для проверки торгового потока без реального кошелька.

Параметры

Без параметров.

get_available_slots

Получает доступные временные слоты для локации на указанную дату. Возвращает время, вместимость, цены и тип активности. Работает для любых услуг, которые можно забронировать (VR, фитнес, рестораны, салоны и т.д.).

Получает доступные временные слоты для локации на указанную дату. Возвращает время, вместимость, цены и тип активности. Работает для любых услуг, которые можно забронировать (VR, фитнес, рестораны, салоны и т.д.).

Параметры

  • locationIdstringобязательный

    Location ID (e.g. loc_downtown, loc_mall)

  • datestringобязательный

    Date in YYYY-MM-DD format

  • activityIdstring

    Optional activity/service ID to filter slots

get_cart

Получает корзину покупок по её идентификатору открытого ключа. Использует W3SHIP_PUBLIC_KEY, если идентификатор не указан.

Получает корзину покупок по её идентификатору открытого ключа. Использует W3SHIP_PUBLIC_KEY, если идентификатор не указан.

Параметры

  • idstring

    Public key ID (hex). Optional if W3SHIP_PUBLIC_KEY is set.

get_identity

Показывает текущий настроенный идентификатор (W3SHIP_PUBLIC_KEY). Возвращает публичный ключ и его тип, ЕСЛИ он задан, или инструкции по настройке, если нет.

Показывает текущий настроенный идентификатор (W3SHIP_PUBLIC_KEY). Возвращает публичный ключ и его тип, ЕСЛИ он задан, или инструкции по настройке, если нет.

Параметры

Без параметров.

get_listing

Получить полные сведения о конкретном объявлении на торговой площадке по ID.

Получить полные сведения о конкретном объявлении на торговой площадке по ID.

Параметры

  • listingIdstringобязательный

    The listing ID

get_order

Получить подробную информацию о конкретном Order (TMF622).

Получить подробную информацию о конкретном Order (TMF622).

Параметры

  • idstringобязательный

    The generic Order ID

get_swap_quote

Получить котировку свапа от Uniswap. Возвращает предполагаемый выход, маршрут, комиссии за газ и влияние на цену. Поддерживает протоколы V2, V3, V4 и UniswapX. Требует переменную окружения UNISWAP_API_KEY.

Получить котировку свапа от Uniswap. Возвращает предполагаемый выход, маршрут, комиссии за газ и влияние на цену. Поддерживает протоколы V2, V3, V4 и UniswapX. Требует переменную окружения UNISWAP_API_KEY.

Параметры

  • tokenInstringобязательный

    Input token symbol (ETH, USDC, USDT, DAI, WETH) or contract address

  • tokenOutstringобязательный

    Output token symbol (ETH, USDC, USDT, DAI, WETH) or contract address

  • amountstringобязательный

    Amount of input token to swap (in human-readable units, e.g. "100" for 100 USDC)

  • walletAddressstring

    Wallet address of the swapper. Uses W3SHIP_PUBLIC_KEY if not provided.

  • chainIdnumber

    Chain ID (default: 8453 for Base)

hold_slot

Бронирует/резервирует временной слот сеанса для клиента. Слот удерживается на 10 минут в ожидании оплаты. Работает для любой услуги, доступной для бронирования.

Бронирует/резервирует временной слот сеанса для клиента. Слот удерживается на 10 минут в ожидании оплаты. Работает для любой услуги, доступной для бронирования.

Параметры

  • slotIdstringобязательный

    The time slot ID to hold

  • cartIdstringобязательный

    The cart ID to associate with the hold

  • participantsnumber

    Number of participants (default: 1)

list_bookings

Вывести список всех подтвержденных бронирований сессий. При необходимости отфильтровать по местоположению или дате.

Вывести список всех подтвержденных бронирований сессий. При необходимости отфильтровать по местоположению или дате.

Параметры

  • locationIdstring

    Filter by location ID

  • datestring

    Filter by date (YYYY-MM-DD)

remove_listing

Удалить объявление с торговой площадки. Только продавец может удалить своё собственное объявление.

Удалить объявление с торговой площадки. Только продавец может удалить своё собственное объявление.

Параметры

  • listingIdstringобязательный

    The listing ID to remove

  • sellerAddressstring

    Seller wallet address (must match listing). Uses W3SHIP_PUBLIC_KEY if not provided.

search_listings

Просматривайте P2P-маркетплейс W3Ship. Ищите по категориям (электроника, подарки, одежда и т.д.) или по ключевому слову. Возвращает активные объявления с ценами и информацией о продавце.

Просматривайте P2P-маркетплейс W3Ship. Ищите по категориям (электроника, подарки, одежда и т.д.) или по ключевому слову. Возвращает активные объявления с ценами и информацией о продавце.

Параметры

  • categorystring

    Filter by category (electronics, clothing, collectibles, home, sports, gifts, books, other)

  • keywordstring

    Search keyword (matches title, description)

  • limitnumber

    Max results to return. Default: 20

ship_address

Безопасно получите физический адрес с помощью открытого ключа и временной криптографической подписи.

Безопасно получите физический адрес с помощью открытого ключа и временной криптографической подписи.

Параметры

  • publicKeystringобязательный

    The hex-encoded public key to lookup.

  • signaturestringобязательный

    The hex-encoded signature of the timestamp.

  • timestampnumberобязательный

    The current Unix timestamp in milliseconds.

track_shipment

Отследить статус доставки отправления (TMF621)

Отследить статус доставки отправления (TMF621)

Параметры

  • shipmentIdstring

    The unique Shipment ID

  • orderIdstring

    The Order ID (optional, to lookup shipment)

Другие проверенные MCP-сервера

mnemox-ai/idea-reality-mcp

mnemox-ai/idea-reality-mcp

официальный

MCP-сервер автоматически проверяет, не сделал ли кто-то уже вашу идею. Сканирует GitHub, Hacker News и другие источники, возвращает оценку реалистичности (0-100) с трендами и советами по пивоту. По...

Python760
TencentCloudBase/CloudBase-AI-ToolKit

TencentCloudBase/CloudBase-AI-ToolKit

официальный

MCP-сервер CloudBase соединяет AI IDE с облачной инфраструктурой Tencent Cloud, позволяя разработчикам развёртывать приложения одной командой. Он заполняет разрыв между генерацией кода и деплоем, автоматизируя настройку функций, баз данных и хостинга. Полезен для AI-программистов, которые хотят у...

TypeScript1059
wanaku-ai/wanaku

wanaku-ai/wanaku

официальный

Wanaku — MCP-маршрутизатор, централизующий управление контекстом для AI-агентов. Поддерживает 400+ интеграций через Apache Camel, встроенную аутентификацию и развертывание в Kubernetes. Упрощает ма...

Java129
scrapegraphai/scrapegraph-ai

scrapegraphai/scrapegraph-ai

ScrapeGraphAI - MCP сервер для веб-скрапинга с LLM: опишите нужные данные, и он построит пайплайн извлечения. Полезен разработчикам и аналитикам для автоматизации сбора информации с сайтов и документов.

Python28460
IvanMurzak/Unity-MCP

IvanMurzak/Unity-MCP

MCP сервер связывает AI-агентов с Unity, автоматизируя создание сцен, генерацию кода и отладку. Работает внутри собранной игры — для динамических NPC и дебага. Полезен геймдев-разработчикам.

C#3597
jae-jae/fetcher-mcp

jae-jae/fetcher-mcp

MCP сервер для извлечения веб-контента через Playwright. Работает с динамическими сайтами, поддерживает JavaScript, умное выделение текста и пакетную загрузку. Идеален для сбора данных и разработки.

TypeScript1065
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин