Каталог MCP
W3Ship/w3ship-mcp-server

W3Ship/w3ship-mcp-server

Name: W3Ship/w3ship-mcp-server
Availability: InStock
Author: baskcart

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

Github NPM Сайт сервера

README

22 инструмента

Версии

Установить сервер

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):

Инструменты были проиндексированы: 18.10.2026

add_item

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

Параметры

cartIdstringобязательный
Идентификатор открытого ключа корзины. Необязателен, если задан W3SHIP_PUBLIC_KEY.
itemobjectобязательный

add_tracking

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

Параметры

carrierstringобязательный
Служба доставки: UPS, FedEx, USPS, DHL и т. д.
orderIdstringобязательный
Идентификатор заказа
sellerAddressstring
Адрес кошелька продавца (для проверки). Использует W3SHIP_PUBLIC_KEY, если не указан.
trackingNumberstringобязательный
Трек-номер перевозчика

check_token_approval

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

Параметры

amountstringобязательный
Сумма для одобрения (в человекочитаемых единицах)
chainIdnumber
Chain ID (по умолчанию: 8453 для Base)
tokenstringобязательный
Символ токена (USDC, USDT, DAI, WETH) или адрес контракта
walletAddressstring
Адрес кошелька. Использует W3SHIP_PUBLIC_KEY, если он не указан.

claim_promo

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

Параметры

fulfillmentChoicestring
Как получить товар: "ship" (высылается по почте на ваш адрес, возможна плата за доставку) или "pickup" (бесплатно, забираете в пункте выдачи). По умолчанию определяется настройками объявления.
listingIdstringобязательный
Идентификатор промо-объявления, который нужно активировать
pickupLocationIdstring
ID пункта выдачи (обязателен, когда существует несколько пунктов выдачи и fulfillmentChoice имеет значение "pickup")
publicKeystring
Ваш публичный ключ / адрес кошелька для проверки личности. Если не указано, использует W3SHIP_PUBLIC_KEY.

confirm_payment

Отправьте транзакцию оплаты в блокчейне для верификации. После оплаты продавцу (отправьте криптовалюту на его адрес кошелька), укажите хеш транзакции здесь, чтобы подтвердить оплату и обновить статус заказа на «оплачено».

Параметры

chainIdnumber
Chain ID, на который был отправлен платёж. По умолчанию: 8453 (Base)
orderIdstringобязательный
Идентификатор заказа для подтверждения оплаты
txHashstringобязательный
Хэш ончейн-транзакции (0x...)

create_cart

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

Параметры

customerobject
idstring
Публичный ключ (hex). Необязателен, если задана переменная окружения W3SHIP_PUBLIC_KEY.

create_listing

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

Параметры

categorystring
Категория: электроника, одежда, предметы коллекционирования, товары для дома, спорт, подарки, книги, промо-товары, прочее.
conditionstring
Состояние товара: new, like_new, used, refurbished. По умолчанию: new
currencystring
Валюта платежа (USDC, ETH, DAI и т. д.). По умолчанию: USDC
descriptionstringобязательный
Описание товара.
expiresInDaysnumber
Объявление истекает через N дней. По умолчанию: 30.
fulfillmentTypestring
Способ выполнения заказа: "ship" (только почта), "pickup" (только самовывоз из магазина), "both" (выбирает клиент). По умолчанию: "ship". Установите "pickup" для распространения промо-материалов с нулевой стоимостью.
isPromoboolean
Устанавливается в true для рекламных/бесплатных товаров. Цена автоматически устанавливается в 0, категория - "promotional".
pickupLocationsobject[]
Точки самовывоза для выполнения заказа в магазине. Обязательно, когда fulfillmentType равен "pickup" или "both".
pricenumberобязательный
Цена (например, 200). Установите 0 для акционных товаров.
promoQuantitynumber
Для промо-позиций: сколько доступно для получения (например, 500). По умолчанию: 100
quantitynumber
Сколько доступно. По умолчанию: 1
sellerAddressstring
Адрес кошелька продавца для оплаты. Использует W3SHIP_PUBLIC_KEY, если адрес не указан.
sellerNamestring
Необязательное отображаемое имя продавца.
shippingCostnumber
Для промо-товаров: стоимость доставки, которую оплачивает покупатель (например, 8.99). По умолчанию: 0
shipsTostring[]
Страны, в которые возможна доставка (например, ["US", "CA"]). По умолчанию: ["US"].
titlestringобязательный
Название товара (например, "PS5 Console")

create_order

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

Параметры

cartIdstringобязательный
ID корзины, которую нужно преобразовать

delete_cart

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

Параметры

idstringобязательный
Идентификатор открытого ключа корзины

generate_demo_key

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

Параметры

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

get_available_slots

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

Параметры

activityIdstring
Необязательный идентификатор активности/услуги для фильтрации слотов
datestringобязательный
Дата в формате ГГГГ-ММ-ДД.
locationIdstringобязательный
Идентификатор местоположения (например, loc_downtown, loc_mall)

get_cart

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

Параметры

idstring
Идентификатор открытого ключа (hex). Необязателен, если задан W3SHIP_PUBLIC_KEY.

get_identity

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

Параметры

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

get_listing

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

Параметры

listingIdstringобязательный
ID объявления

get_order

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

Параметры

idstringобязательный
Универсальный идентификатор заказа

get_swap_quote

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

Параметры

amountstringобязательный
Количество входного токена для обмена (в понятных человеку единицах, например «100» для 100 USDC)
chainIdnumber
Chain ID (по умолчанию: 8453 для Base)
tokenInstringобязательный
Введите символ токена (ETH, USDC, USDT, DAI, WETH) или адрес контракта
tokenOutstringобязательный
Символ токена (ETH, USDC, USDT, DAI, WETH) или адрес контракта
walletAddressstring
Адрес кошелька сваппера. Использует W3SHIP_PUBLIC_KEY, если адрес не указан.

hold_slot

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

Параметры

cartIdstringобязательный
Идентификатор корзины для привязки к удержанию
participantsnumber
Количество участников (по умолчанию: 1)
slotIdstringобязательный
Идентификатор временного слота, который нужно зарезервировать.

list_bookings

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

Параметры

datestring
Фильтрует по дате (YYYY-MM-DD)
locationIdstring
Фильтрует по ID местоположения.

remove_listing

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

Параметры

listingIdstringобязательный
Идентификатор объявления, которое нужно удалить.
sellerAddressstring
Адрес кошелька продавца (должен совпадать с листингом). Использует W3SHIP_PUBLIC_KEY, если не указан.

search_listings

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

Параметры

categorystring
Фильтрует по категории (электроника, одежда, коллекционные предметы, дом, спорт, подарки, книги, другое).
keywordstring
Ключевое слово для поиска (совпадает с названием и описанием)
limitnumber
Максимум результатов для возврата (1–20, по умолчанию 10)

ship_address

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

Параметры

publicKeystringобязательный
Открытый ключ в hex-кодировке для поиска.
signaturestringобязательный
Подпись временной метки в hex-кодировании.
timestampnumberобязательный
Текущая метка времени Unix в миллисекундах.

track_shipment

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

Параметры

orderIdstring
Идентификатор заказа (необязательно, для поиска отгрузки)
shipmentIdstring
Уникальный идентификатор отгрузки

`1.7.0`основная	05.03.2026
`1.6.0`	03.03.2026
`1.5.0`	02.03.2026
`1.4.0`	02.03.2026
`1.3.0`	02.03.2026
`1.2.0`	01.03.2026
`1.1.0`	01.03.2026
`1.0.0`	01.03.2026

Выберите клиент, чтобы установить W3Ship/w3ship-mcp-server:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "w3ship-w3ship-mcp-server-0czjxxnxp2": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "w3ship-mcp-server"
      ],
      "env": {
        "VALKEY_HOST": "localhost",
        "VALKEY_PORT": "6379"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"w3ship-w3ship-mcp-server-0czjxxnxp2\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"w3ship-mcp-server\"],\"env\":{\"VALKEY_HOST\":\"localhost\",\"VALKEY_PORT\":\"6379\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add w3ship-w3ship-mcp-server-0czjxxnxp2 --env VALKEY_HOST=localhost --env VALKEY_PORT=6379 -- npx -y w3ship-mcp-server

Либо через JSON-конфиг:

claude mcp add-json w3ship-w3ship-mcp-server-0czjxxnxp2 "{\"command\":\"npx\",\"args\":[\"-y\",\"w3ship-mcp-server\"],\"env\":{\"VALKEY_HOST\":\"localhost\",\"VALKEY_PORT\":\"6379\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add w3ship-w3ship-mcp-server-0czjxxnxp2 --env VALKEY_HOST=localhost --env VALKEY_PORT=6379 -- npx -y w3ship-mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.w3ship-w3ship-mcp-server-0czjxxnxp2]
command = "npx"
args = ["-y", "w3ship-mcp-server"]

[mcp_servers.w3ship-w3ship-mcp-server-0czjxxnxp2.env]
VALKEY_HOST = "localhost"
VALKEY_PORT = "6379"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите W3Ship/w3ship-mcp-server, а в поле команды запуска — строку ниже:

npx -y w3ship-mcp-server

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

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

Continue

Создайте файл в .continue/mcpServers/ (например w3ship-w3ship-mcp-server-0czjxxnxp2.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: w3ship-w3ship-mcp-server-0czjxxnxp2
    command: npx
    args:
      - "-y"
      - "w3ship-mcp-server"
    env:
      VALKEY_HOST: localhost
      VALKEY_PORT: 6379

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 1
Форков на Github: 1
Загрузок: 620
Язык реализации: JavaScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.10 в 09:43
Идентификатор: QiErfDeaBBJSJHMx
Категории: E-commerce, Блокчейн

W3Ship/w3ship-mcp-server

W3Ship Commerce MCP Server

⚡ Quick Start

Install via npx (recommended)

Похожие MCP-сервера

patchistry/patchistry-mcp-server

nicktcode/swissgroceries-mcp

Вкусвилл MCP

catrinmdonnelly/royalmail-mcp

СДЭК MCP

ReplenishRadar/MCP