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, если он не указан.

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

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

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

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

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

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

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

    The order ID

  • sellerAddressstring

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

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

    Carrier tracking number

check_token_approval

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

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

    Amount to approve (in human-readable units)

  • chainIdnumber

    Chain ID (default: 8453 for Base)

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

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

  • walletAddressstring

    Wallet address. Uses W3SHIP_PUBLIC_KEY if not provided.

claim_promo

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

Параметры
  • 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.

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

    The promotional listing ID to claim

  • pickupLocationIdstring

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

  • publicKeystring

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

confirm_payment

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

Параметры
  • chainIdnumber

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

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

    The order ID to confirm payment for

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

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

create_cart

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

Параметры
  • customerobject
  • idstring

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

create_listing

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

Параметры
  • categorystring

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

  • conditionstring

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

  • currencystring

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

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

    Item description

  • expiresInDaysnumber

    Listing expires after N days. Default: 30

  • fulfillmentTypestring

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

  • isPromoboolean

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

  • pickupLocationsobject[]

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

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

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

  • promoQuantitynumber

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

  • quantitynumber

    How many available. Default: 1

  • sellerAddressstring

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

  • sellerNamestring

    Optional display name for the seller

  • shippingCostnumber

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

  • shipsTostring[]

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

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

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

create_order

Преобразовать корзину покупок в подтвержденный заказ (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 и другими инструментами. Пригодится для проверки торгового потока без реального кошелька.

Параметры

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

get_available_slots

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

Параметры
  • activityIdstring

    Optional activity/service ID to filter slots

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

    Date in YYYY-MM-DD format

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

    Location ID (e.g. loc_downtown, loc_mall)

get_cart

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

Параметры
  • idstring

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

get_identity

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

Параметры

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

get_listing

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

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

    The listing ID

get_order

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

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

    The generic Order ID

get_swap_quote

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

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

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

  • chainIdnumber

    Chain ID (default: 8453 for Base)

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

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

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

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

  • walletAddressstring

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

hold_slot

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

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

    The cart ID to associate with the hold

  • participantsnumber

    Number of participants (default: 1)

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

    The time slot ID to hold

list_bookings

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

Параметры
  • datestring

    Filter by date (YYYY-MM-DD)

  • locationIdstring

    Filter by location ID

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. Ищет по категории (электроника, подарки, одежда и т.д.) или ключевому слову. Возвращает активные объявления с ценами и информацией о продавце.

Параметры
  • 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)

Параметры
  • orderIdstring

    The Order ID (optional, to lookup shipment)

  • shipmentIdstring

    The unique Shipment ID

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

apify/actors-mcp-server

apify/actors-mcp-server

официальный

Apify MCP Server подключает AI-агентов к тысячам готовых парсеров и краулеров из Apify Store - от соцсетей до карт и e-commerce. Поддерживает OAuth, x402 и Skyfire для оплаты без API-токена.

TypeScript6676
MeshLedger/MeshLedger

MeshLedger/MeshLedger

MeshLedger — MCP-сервер для AI-маркетплейса с ончейн-эскроу и репутацией. Позволяет агентам искать навыки, создавать и выполнять заказы, разрешать споры. Полезен разработчикам и пользователям MCP-к...

TypeScript3
gblinproject/GBLIN-MCP

gblinproject/GBLIN-MCP

MCP-сервер для AI-агентов на Base: держите капитал в диверсифицированном индексе GBLIN с Crash-щитом и мгновенно обменивайте на USDC по x402-счетам. Включает 8 инструментов — от проверки состояния ...

JavaScript1
pepabo/colormeshop-mcp

pepabo/colormeshop-mcp

MCP-сервер для японской e-commerce платформы Color Me Shop. Управляйте заказами, товарами, клиентами и купонами через естественный язык — просто опишите задачу ИИ (Claude, Cursor). Бесплатно для вс...

JavaScript1
CCXT MCP

CCXT MCP

MCP сервер на базе CCXT позволяет AI-моделям торговать на 100+ криптобиржах, получать рыночные данные и анализировать эффективность. Поддерживает ордера, баланс и управление рисками. Идеален для автоматизации.

TypeScript93
arcadia-finance/mcp-server

arcadia-finance/mcp-server

MCP-сервер для платформы Arcadia Finance — управляйте концентрированной ликвидностью на Uniswap и Aerodrome, автоматизируйте ребалансировку и компаундинг. Через read- и write-инструменты AI-агенты ...

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

Лука Никитин