Agents on market0x

claude mcp add --transport http market0x https://www.market0x.com/api/mcp

{
  "mcpServers": {
    "market0x": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.market0x.com/api/mcp"]
    }
  }
}

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://www.market0x.com/api/mcp"),
));

// Every tool result is JSON in content[0].text.
async function call(name, args = {}) {
  const res = await client.callTool({ name, arguments: args });
  const data = JSON.parse(res.content.find((c) => c.type === "text").text);
  if (res.isError) throw new Error(data.error);
  return data;
}

Reads

• list_micro_marketsread
  List the markets this marketplace facilitates — asset, chain, settlement currencies, and fee.
• get_listingsread
  Active listings and auctions for a market, each with its ask, underlying contents priced at market, and discount — sorted by discount.
• get_listing_detailsread
  Full detail for one order, including a fresh live snapshot of the position's contents.
• get_recent_tradesread
  Recently filled orders (sales) for a market.
• get_ordersread
  Orders created by an address — its listings, auctions, and offers.
• get_owned_positionsread
  Positions an address owns in a market, with per-position listability.

Buy & bid

• prepare_purchaseprepare
  Prepare the non-custodial package to buy a listing or accept an offer — ordered approvals plus Seaport fulfill calldata.
• prepare_offerprepare
  Prepare a bid/offer to sign — the Seaport order (EIP-712), the currency approval, and how to submit it.

Sell & manage

• prepare_listingprepare
  Prepare a sell listing or Dutch auction — verifies ownership and transferability, then returns the NFT approval plus EIP-712 order to sign.
• prepare_cancelprepare
  Prepare the on-chain Seaport cancel transaction for an active order (only the offerer can execute it).

Notifications

• subscribe_notificationssigned action
  Subscribe a wallet to push notifications via an HMAC-signed webhook — the agent-native alternative to polling.
• list_subscriptionsread
  List a wallet's notification subscriptions (webhook URLs redacted to origin).
• unsubscribe_notificationssigned action
  Delete a notification subscription.

// 1) pick a market, 2) find the biggest discount, 3) prepare the buy.
const { markets } = await call("list_micro_markets");

const { listings } = await call("get_listings", {
  marketId: "veaero", kind: "listing", minDiscountPct: 8,   // >= 8% below underlying
});
if (!listings.length) return;                                // nothing cheap enough
const best = listings[0];                                    // sorted by discount desc

const { prepared, contents, valueDrift } = await call("prepare_purchase", {
  orderHash: best.orderHash,
});
// prepared = { approvals:[...], fill:{to,data,value}, signed }
// Sign + submit with YOUR wallet — the server never holds keys:
for (const a of prepared.approvals) await wallet.sendTransaction(a);
await wallet.sendTransaction(prepared.fill);

// Bid on a specific position. prepare_offer returns an order to SIGN.
const { order, orderHash, approval, signing } = await call("prepare_offer", {
  marketId: "veaero", tokenId: "130647", currencySymbol: "USDC",
  offerAmount: "3.10",                         // human amount the seller nets
  buyer: myAddress,
});

// 1) approve the currency to the conduit so the offer is fillable:
await wallet.sendTransaction({ to: approval.token, data: erc20Approve(approval.spender, approval.amount) });

// 2) sign the EIP-712 order (the Seaport counter is already set — do not change it):
const signature = await wallet.signTypedData({
  domain: signing.domain, types: signing.types, primaryType: signing.primaryType,
  message: toOrderComponents(order),
});

// 3) POST the signed order to the book — settlement stays on Seaport:
await fetch("https://www.market0x.com/api/listings", {
  method: "POST", headers: { "content-type": "application/json" },
  body: JSON.stringify({ order, signature, orderHash }),
});

// List a position you own (or a Dutch auction with startAsk/endAsk).
const { order, orderHash, approval, signing } = await call("prepare_listing", {
  marketId: "veaero", tokenId: "130647", kind: "listing",
  currencySymbol: "USDC", seller: myAddress, ask: "3.10",   // price you net
});

// one-time per collection: setApprovalForAll(conduit, true)
await wallet.sendTransaction({ to: approval.to, data: approval.data });

const signature = await wallet.signTypedData({
  domain: signing.domain, types: signing.types, primaryType: signing.primaryType,
  message: toOrderComponents(order),
});
await fetch("https://www.market0x.com/api/listings", {
  method: "POST", headers: { "content-type": "application/json" },
  body: JSON.stringify({ order, signature, orderHash }),
});

// Get pushed events instead of polling. Two steps: sign, then subscribe.
const now = Math.floor(Date.now() / 1000);
const base = {
  wallet: myAddress, chainId: 8453, channel: "webhook",
  webhookUrl: "https://my-agent.example.com/hook",
  events: ["order_filled", "offer_received"], timestamp: now,
};

// 1) call WITHOUT a signature to get the exact message to personal_sign:
const { messageToSign } = await call("subscribe_notifications", base);
const signature = await wallet.signMessage({ message: messageToSign });

// 2) call again WITH the signature. The webhook HMAC secret is returned ONCE:
const { id, webhookSecret } = await call("subscribe_notifications", { ...base, signature });

// verify each delivery: hex(HMAC-SHA256(rawBody, webhookSecret)) === x-market0x-signature