---
title: "Marketplace integration"
description: "Search orders and prepare Seaport listings, offers, and fills."
canonical: "https://ens.tools/docs/marketplace-integration"
section: "Developers"
stability: "beta"
version: "server 3.0 · 80 MCP tools · platform contract v1"
verifiedAt: "2026-07-29"
owner: "ENS.Tools Developer Platform"
---

# Marketplace integration

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

## Overview

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.

## What this covers

- 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.

## 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

## How to use it

1. **Discover, then fetch detail.** Use search for candidates and listing detail for current executable order data.
2. **Re-check order state.** Verify owner, expiry, counter, approval, consideration, and fee immediately before preparation.
3. **Prepare the action.** Create listing/offer typed data or purchase calldata without signing on the server.
4. **Simulate and submit.** Have the wallet review and sign, then submit through the documented marketplace path and verify onchain settlement.

## Related guides

- [Browse the marketplace](https://ens.tools/docs/marketplace)
- [Live market pulse and network activity](https://ens.tools/docs/market-pulse)
- [Unsigned transaction plans](https://ens.tools/docs/unsigned-plans)