Sell to people and AI agents: create products, a storefront, and USDC payment links from chat.
| Endpoint | https://mcp.swopme.co/mcp/commerce (streamable-http) |
|---|---|
| Registry version | 0.2.1 |
| Now | 27 tools · grade F (6) · pin ts_add4dbed1785fdc4135b832bb75705d8 · protocol 2025-06-18 |
| First / last listed | 2026-11-06 02:14 UTC / 2026-11-06 02:14 UTC |
| Grade over time | 2026-11-06: F (6), 27 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: swop_search_identities swop_lookup_identity swop_get_help swop_get_my_profile swop_get_my_balances swop_get_my_orders swop_list_my_tokens swop_get_my_smartsite swop_update_my_smartsite swop_add_link swop_remove_link swop_create_feed_post swop_create_product swop_create_checkout swop_get_checkout swop_list_webhooks swop_register_webhook swop_test_webhook swop_remove_webhook swop_list_embed_origins swop_register_embed_origin swop_remove_embed_origin swop_feature_product swop_list_my_products swop_update_product swop_get_product_link swop_get_store
swop_search_identities | Search Swop user identities (swop.ids) by handle or display name. Returns handle, display name, avatar, and public EVM/Solana wallet addresses. Use this to find a user or resolve a name to a wallet address. params: query*, limit |
swop_lookup_identity | Resolve an exact swop.id handle (e.g. "travis.swop.id") to its profile: display name, avatar, and public EVM/Solana wallet addresses. Case-insensitive exact match; use swop_search_identities for fuzzy search. params: handle* |
swop_get_help | Answer "what can I do with Swop?" (returns the plain-language list of what this connection can do for the user) and look up Swop's own how-to answers on payment previews, funded claim links, Goldman AI credits, companion pairing and saved context. Use it when the user asks what Swop can do or how a feature works; for their own data use the swop_get_my_* tools instead. Returns the closest curated a params: query* |
swop_get_my_profile | The linked user's own Swop account: name, email, and SmartSites (handle, bio). Use swop_lookup_identity or swop_search_identities for anyone else's profile. If no Swop account is connected, the call fails asking the user to connect it. params: none |
swop_get_my_balances | Current wallet balance snapshot for the linked Swop account (total USD and per-asset breakdown). For tokens or merchant Bucks the account has launched, use swop_list_my_tokens instead. params: none |
swop_get_my_orders | Recent marketplace orders for the linked Swop account, both sides: sales of your products and your purchases. Shows payment, escrow/settlement, and fulfillment status. params: none |
swop_list_my_tokens | Community tokens and merchant Bucks the linked account has launched on Base, with live balances (for the overall wallet total use swop_get_my_balances). Read-only. Merchant Bucks are STORE CREDIT (isStoreCredit: true, 2 decimals) — never add them into a portfolio or cash total. An empty list means nothing has been launched yet, not an error. params: none |
swop_get_my_smartsite | Get the linked account's current SmartSite so you can see it BEFORE editing: name, bio, appearance (background/theme), the links already on it (icons, buttons, info bars, with their item ids for removal), product tiles, and a viewUrl to preview it. ALWAYS call this before adding or changing things so edits stay additive. params: smartsiteId |
swop_update_my_smartsite | Edit the linked account's SmartSite: display name, bio, and appearance (background color, a gradient of hex stops, a background image URL, theme/font color, font family, or header layout). Pass only what you want to change. For adding links/buttons/info bars use swop_add_link; for products use swop_create_product / swop_feature_product. params: name, bio, backgroundColor, backgroundGradient, backgroundImg, themeColor, fontColor, fontFamily, headerFormat, smartsiteId |
swop_add_link | Add a link to the linked account's SmartSite, with smart placement. TWO STEPS: (1) call with just the url — the tool detects what kind of link it is (payment like Venmo/PayPal/Cash App, social, contact, website) and returns a recommendation with a text preview of each layout: a small ICON in the icon row, a link BUTTON tile, or a full-width INFOBAR call-to-action card. Show the user the message + params: url*, displayAs, title, buttonName, description, style, smartsiteId |
swop_remove_link | Remove a link/icon/info-bar/product tile from the SmartSite. Get the item's id and contentType from swop_get_my_smartsite (icons → 'socialTop', buttons → 'socialLarge', info bars → 'infoBar', product tiles → 'marketPlace'). Confirm with the user first. params: contentType*, itemId*, smartsiteId |
swop_create_feed_post | Publish a PUBLIC post to the Swop feed as the linked account's SmartSite: a caption plus up to 4 images. Each image may be an https URL, a data:image/...;base64 URI, or bare base64 (PNG/JPEG/GIF/WebP, max 5 MB; keep inline images under ~3 MB total so the request fits). TWO-STEP like swop_send: call WITHOUT confirm to get a preview — Swop hosts the images and returns who it posts as, the exact capt params: caption, images, smartsiteId, previewId, confirm |
swop_create_product | Start selling something in one call: creates a product that people can buy on the linked account's Swop SmartSite and AI agents can buy in USDC over x402, with no store setup, payment processor, or verification needed. To change an existing product use swop_update_product instead. name, description and image are all REQUIRED by the backend. Confirm name and price with the user before creating. The params: name*, description*, priceUsd*, image*, extraImages, productType, nftType, mintLimit, keywords, variants, requiresShipping, shippingCost, digitalDeliveryNote, royaltyPercentage, royaltyRecipient |
swop_create_checkout | Take payment on the seller's own website: creates a checkout for a cart of the linked account's OWN products, so a buyer pays there instead of being sent to Swop. For a single shareable link use swop_get_product_link instead. Prices come from the seller's catalogue and must NOT be sent — a price in the request is rejected. Shipping is charged automatically for physical products, and for those the params: items*, buyerName, buyerEmail, buyerPhone, shippingAddress, offerCard, description |
swop_get_checkout | Read back a checkout created with swop_create_checkout: its status (active, pending_payment, paid, settled, expired, cancelled), the payment request if one is published, and the line items. Poll this after the buyer has been shown the payment to learn when it lands — paid means the buyer's money arrived; settled means the seller has been paid out. Only the linked account's own checkouts are visibl params: intentId* |
swop_list_webhooks | Show the webhook endpoints Swop notifies when the linked account gets paid, and the events available. Two events: checkout.paid (the buyer's money arrived and an order exists) and payout.released (Swop released the seller's money — for a card sale that can be days later). Use before adding or removing one. params: none |
swop_register_webhook | Get notified the moment the user gets paid. Register an https URL that Swop will POST a signed JSON event to when the linked account gets paid (checkout.paid) and paid out (payout.released). Returns a signing secret ONCE — tell the user to store it now; it cannot be retrieved again. Deliveries carry a Swop-Signature header: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" with the secret>; params: url*, events, label |
swop_test_webhook | POST a signed 'ping' event to one of the linked account's webhooks right now and report the HTTP status the endpoint returned. Use to confirm an integration before relying on it. params: id* |
swop_remove_webhook | Stop sending events to one of the linked account's webhook URLs. Pending deliveries to it are dropped. Confirm with the user first. params: id* |
swop_list_embed_origins | Show which websites may currently display the linked account's Swop checkout in a frame. Use before adding or removing one so the user can see what is already allowed. params: none |
swop_register_embed_origin | Allow ONE website to display the linked account's Swop checkout inside a frame. This is a security setting: only registered origins can ever frame the checkout, so a leaked API key still cannot put it on someone else's site. Give a bare origin — scheme and host only, https (http allowed for localhost), no wildcards, no path. Confirm the exact origin with the user first. params: origin*, label |
swop_remove_embed_origin | Remove a website from the list allowed to frame the linked account's checkout. Takes an id from swop_list_embed_origins. Afterwards that site can no longer display the checkout. params: id* |
swop_feature_product | Show an existing product on the linked account's SmartSite as a tile visitors can buy from. Pass the templateId returned by swop_create_product (or the id from swop_list_my_products). Each call ADDS a new tile and never replaces existing ones, so check swop_get_my_smartsite first to avoid duplicates; remove a tile with swop_remove_link. The product must belong to the linked account. params: templateId*, carouselTitle, smartsiteId |
swop_list_my_products | List the linked account's OWN products (each with its id, name, price, inventory, and status); to browse another seller's products use swop_get_store. Use the id with swop_update_product (to edit or unlist) or swop_feature_product (to show it on the SmartSite). params: none |
swop_update_product | Edit one of the linked account's products, or unlist it. Pass its productId (from swop_list_my_products) plus ONLY the fields to change — anything omitted keeps its current value. To unlist it, set status to 'archived'. Confirm price and name changes with the user first. params: productId*, name, description, priceUsd, image, extraImages, mintLimit, keywords, variants, requiresShipping, shippingCost, digitalDeliveryNote, royaltyPercentage, royaltyRecipient, status |
swop_get_product_link | Get one link that sells to everyone: a person who opens it sees a product page with a Buy button, and an AI agent that requests it gets an x402 USDC payment challenge. Use this to share a product in chat, a social post, or a message. params: handle*, sku* |
swop_get_store | See what any swop.id sells and buy it: lists the products a swop.id sells on their SmartSite, with USDC prices and each product's x402 buyUrl (for the linked account's own catalogue use swop_list_my_products). An agent with an x402-capable wallet purchases by GETting the buyUrl: the first request returns HTTP 402 with payment instructions (exact USDC amount, network, pay-to address), and retrying params: handle* |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.