com.market0x/marketplace

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Buy, sell and bid on vote-escrow NFTs and .base.eth names. Non-custodial, settles on Seaport.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "marketplace": {
      "url": "https://www.market0x.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• list_micro_markets

  List the markets this marketplace facilitates (asset, chain, currencies, fee).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_listings

  Active listings/auctions for a market. Each row carries the ask and the position's underlying contents priced at current market (published formula: /docs#data-sources), plus discountPct (the difference between them). Sorted by discount percentage, descending.

  Parameters:

  • marketId (required) — string — market id, e.g. 'vehydx'
  • kind — string
  • limit — number
  • nameContains — string — case-insensitive substring match on the listing's label (the name on name markets, e.g. 'alice'; 'veAERO #123' elsewhere)
  • minDiscountPct — number — only return orders at >= this discount %. IGNORED on markets whose asset has no priced underlying, where there is nothing to compare the ask against — the response says so in `note` rather than returning an empty market.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_listing_details

  Full detail for one order including a FRESH live-contents snapshot (principal, claimable rewards, voting/earning power, as_of_block).

  Parameters:

  • orderHash (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_recent_trades

  Recently settled sales for a market. `amount` is the EXACT settled total (incl. fee) from the on-chain fill where the indexer recorded it, with `settledAt` the block time and `exact: true`; otherwise it falls back to the listed ask with `exact: false` (a decayed Dutch auction settles BELOW its listed amount, so treat inexact rows as an upper bound).

  Parameters:

  • marketId (required) — string
  • limit — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prepare_purchase

  Prepare the non-custodial transaction package to BUY a listing (or accept an offer): ordered approvals + Seaport fulfillOrder calldata + a fresh contents snapshot. prepared.summary quotes the CURRENT price (Dutch auctions interpolate, asOf says when); the approval grants approveBaseUnits — slightly above the quote on a decaying order, never above maxTotalBaseUnits — and Seaport charges the exact interpolated amount at fill. On auctions, prepared.cleanup is an optional post-settlement tx that zeroes the residual allowance. The agent's own wallet signs and submits — this never signs or holds keys.

  Parameters:

  • orderHash (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prepare_offer

  Prepare a BID/offer on a position: returns the Seaport order to sign (EIP-712), the currency approval needed, and how to submit it. The agent reads its Seaport counter, signs, and POSTs the signed order — settlement stays on Seaport.

  Parameters:

  • marketId (required) — string
  • currencySymbol (required) — string — one of the market's settlementCurrencies (see list_micro_markets)
  • offerAmount (required) — string — human amount the seller nets, e.g. '750' — must be positive
  • buyer (required) — string — 0x address that will sign and fund the offer
  • name — string — name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived
  • tokenId — string — required for token markets (e.g. vehydx)
  • durationDays — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prepare_listing

  Prepare a SELL listing or Dutch auction. Verifies the seller OWNS the position and it's transferable (not voted/attached), builds the Seaport order with the Interface fee injected by the server, and returns the one-time NFT approval + EIP-712 typed data to sign. Never signs or holds keys.

  Parameters:

  • marketId (required) — string
  • kind (required) — string
  • currencySymbol (required) — string — one of the market's settlementCurrencies (see list_micro_markets)
  • seller (required) — string
  • ask — string — listing: price the seller nets — must be positive
  • name — string — name markets only, e.g. 'alice' or 'alice.base.eth' — tokenId is derived
  • endAsk — string — dutch_auction: floor price (must be below the start)
  • tokenId — string — required for token markets (e.g. vehydx)
  • startAsk — string — dutch_auction: starting (high) price
  • durationDays — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prepare_cancel

  Prepare the on-chain Seaport cancel transaction for an active order. Only the order's offerer can execute it (Seaport enforces msg.sender == offerer), so the calldata is safe to return. After it confirms, POST { txHash } to the confirm endpoint to update the book.

  Parameters:

  • orderHash (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_orders

  List orders created by an address (its listings, auctions, offers). Status is reconciled by the background worker — treat as advisory until checked at fill.

  Parameters:

  • offerer (required) — string
  • status — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_owned_positions

  List the positions an address owns in a market, with listability (voted/attached positions can't transfer).

  Parameters:

  • marketId (required) — string
  • owner (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• subscribe_notifications

  Subscribe a wallet to push notifications (order_filled / offer_received / saved_search) via an HMAC-signed webhook — the agent-native alternative to polling. Two-step: call WITHOUT `signature` to get the exact message to sign (EIP-191 personal_sign), then call again WITH the signature. `chainId` is signed over and the signature is verified on THAT chain, so pass the chain the wallet actually signs on (smart-wallet signatures do not validate cross-chain). Each signed message is SINGLE-USE: resending the same body returns 409 replayed_signature — retry with a fresh timestamp and a new signature. The response includes the webhook HMAC secret ONCE (verify x-market0x-signature = hex(HMAC-SHA256(rawBody, secret))).

  Parameters:

  • wallet (required) — string
  • chainId (required) — integer — chain the wallet signs on; it is part of the signed message
  • channel (required) — string
  • events (required) — array
  • timestamp (required) — number — unix seconds; must be within 10 minutes of now
  • signature — string — EIP-191 signature of the canonical message; omit to receive the message to sign
  • webhookUrl — string — https URL; required for the webhook channel
  • savedSearch — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_subscriptions

  List a wallet's notification subscriptions (webhook URLs redacted to origin).

  Parameters:

  • wallet (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• unsubscribe_notifications

  Delete a notification subscription. Two-step like subscribe_notifications: call without `signature` to get the message to sign. `chainId` is signed over and verified on that chain. Signed messages are single-use.

  Parameters:

  • wallet (required) — string
  • chainId (required) — integer — chain the wallet signs on; it is part of the signed message
  • subscriptionId (required) — string
  • timestamp (required) — number
  • signature — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.