Tool reference

All 51 Swop MCP tools by category, with the sign-in scope, endpoint and confirmation rules for each.

Every page in this section is generated from the server's own tools/list response (Swop MCP 0.2.2), so names, descriptions, inputs and limits match exactly what an MCP client receives.

How to read the badges on each tool

No sign-in or Sign-in: scope: whether the tool needs a linked Swop account, and which OAuth scope the user must grant. See Account linking & caps.
/mcp only or /mcp and /mcp/commerce: which endpoint exposes it.
Preview, then confirm: the tool runs in two calls and needs the user's explicit yes in between.
Read-only or Changes or moves things: the MCP annotation the server publishes for clients that show it.

Identity & stores (4)

swop.id lookup and search, any seller's store, shareable product links.

Prediction market data (9)

Markets, events, live status, order books, prices, history, taxonomy.

Account & lookups (7)

Profile, balances, orders, launched tokens, verified prices, sports, help.

SmartSite & feed (5)

Read and edit the SmartSite, add or remove links, post to the feed.

Products & checkout (13)

Products, checkout on your site, webhooks, embed origins.

Money (5)

Spending settings, sends, x402 links, swap quotes and swaps.

Trading (4)

Perps and prediction-market orders.

Agent control (4)

The user's AI trading agent: read, message, manage.

Conventions shared by every tool

Results are one text content item with a JSON payload. Errors set isError: true and say what went wrong, including the upstream HTTP status.
Money amounts are in USD unless a field says token units or base units (amount on swaps is in the input token's smallest unit).
Two-step tools take previewId and confirm. Call once without them, show the preview, then call with both. Previews are single-use.
Archiving, not deleting. Products are unlisted with swop_update_product status: "archived".