Browse all documentation
Developers · 7 of 7

Marketplace integration

Search orders and prepare Seaport listings, offers, and fills.

betaserver 3.0 · 79 MCP tools · platform contract v1Verified 2026-07-29Owner: ENS.Tools Developer Platform

Marketplace tools expose indexed inventory and prepare Seaport 1.6 actions. Signed order data remains essential: a price row without an executable order is not enough to prepare a purchase.

marketplace_search, marketplace_listing, marketplace_stats, and get_market_activity.
prepare_marketplace_listing and prepare_marketplace_offer return Seaport EIP-712 typed data plus submission templates.
prepare_marketplace_purchase returns atomic fill calldata for a supplied signed basic order.
Native orders include the 2% ENS.Tools fee atomically.
Production contract

Before you run this workflow

Networks

  • Ethereum mainnet for onchain plans
  • HTTPS for MCP and public APIs

Prerequisites

  • JSON-RPC 2.0 client for MCP
  • Read the live platform contract and tool schemas at runtime

Wallet permissions

  • MCP never receives private keys
  • Prepared writes must be reviewed, signed, and broadcast by a separate wallet

Expected result

  • Structured JSON data or an unsigned plan with chain, target, calldata, value, and safety metadata

Errors and recovery

  • Call tools/list again after schema errors
  • Back off after rate limits
  • Simulate immediately before signing
Workflow

How to use it

  1. 1

    Discover, then fetch detail

    Use search for candidates and listing detail for current executable order data.

  2. 2

    Re-check order state

    Verify owner, expiry, counter, approval, consideration, and fee immediately before preparation.

  3. 3

    Prepare the action

    Create listing/offer typed data or purchase calldata without signing on the server.

  4. 4

    Simulate and submit

    Have the wallet review and sign, then submit through the documented marketplace path and verify onchain settlement.