Koskamo

Swop MCP

An MCP server enabling AI agents to create products, manage storefronts, and process USDC payments via x402 challenges. It supports public tools for browsing stores and private tools for product management, checkout, and SmartSite editing, requiring OAuth 2.1 for account-specific actions.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Swop MCP logo, by TravisswopCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Travisswop
You need:Public tools need no account; account tools use OAuth 2.1 (dynamic client registration, PKCE)
MCP endpoint (Streamable HTTP)
https://mcp.swopme.co/mcp/commerce
Vendor documentation

What its tools do

27 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (14)

Can change data (13)

27 of 27 have a description · 27 of 27 declare behavior hints · 20 of 20 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Create products and generate payment links for people and AI agents
  • Browse seller stores and retrieve USDC prices with x402 buy URLs
  • Manage SmartSite storefronts and edit links
  • Process checkout events via signed webhooks

Source and maintenance

Community listingRegistry 0.2.1
mcp-registry: io.github.Travisswop/swop@0.2.1Source repository
Maintenance checked

Protocol and capabilities

Server
swop-commerce 0.2.2
MCP protocol negotiated in check
2025-11-25
Tools
27 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Swop lets the user sell to people and AI agents and get paid in USDC, all from chat. What the user can do with Swop from this chat: - Sell: turn anything into a product with one link — people buy on a Buy page and AI agents pay automatically in USDC; show it on their Swop page; take checkout on their own website with signed webhooks; see their orders. - Their Swop page (SmartSite): change the name, bio, look and links; post to their feed. - Look things up: people by swop.id, any seller's store, their own profile, balances and the tokens they launched. This connection cannot move money: sends, payments, swaps, trading and their AI trading agent live in the Swop app. Talk about Swop in plain language, as what the user can sell, see, send or change. Never mention tool names, scopes, endpoints, repositories, APIs or infrastructure to the user, and when asked what you can do answer from the list above and nothing beyond it. For "sell X", "make me a store" or "take payments": create the product, feature it on their SmartSite, then share its link. To buy from a Swop seller, read their store first. Always confirm prices and any payment with the user before acting.

Tools

27 advertised

swop_search_identities — Search swop.id identities
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

swop_search_identities input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Max results, default 8"
    },
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Handle or name fragment, at least 2 characters (e.g. \"travis\")"
    }
  },
  "additionalProperties": false
}
swop_search_identities annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}
swop_lookup_identity — Look up a swop.id
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

swop_lookup_identity input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Exact swop.id handle, e.g. \"travis.swop.id\""
    }
  },
  "additionalProperties": false
}
swop_lookup_identity annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}
swop_get_help — Swop help
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 answer, or says the topic is not covered.

swop_get_help input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 240,
      "description": "The question in plain words, e.g. \"how do claim links work\" or \"what are Goldman credits\". Max 240 characters."
    }
  },
  "additionalProperties": false
}
swop_get_help annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_get_my_profile — Get my Swop profile
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_get_my_profile input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_get_my_profile annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_get_my_balances — Get my wallet balances
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_get_my_balances input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_get_my_balances annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_get_my_orders — Get my orders
Advertised by the server during the last successful anonymous check.
Advertised read-only

Recent marketplace orders for the linked Swop account, both sides: sales of your products and your purchases. Shows payment, escrow/settlement, and fulfillment status.

swop_get_my_orders input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_get_my_orders annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_list_my_tokens — List my Launchpad tokens
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_list_my_tokens input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_list_my_tokens annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_get_my_smartsite — See my SmartSite
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_get_my_smartsite input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "smartsiteId": {
      "type": "string",
      "description": "Specific SmartSite id (default: primary)"
    }
  },
  "additionalProperties": false
}
swop_get_my_smartsite annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_update_my_smartsite — Edit my SmartSite (name, bio, background)
Advertised by the server during the last successful anonymous check.

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.

swop_update_my_smartsite input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "bio": {
      "type": "string",
      "maxLength": 500,
      "description": "New bio text"
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "description": "New display name"
    },
    "fontColor": {
      "type": "string",
      "description": "Primary font hex color"
    },
    "fontFamily": {
      "type": "string",
      "description": "Font family name"
    },
    "themeColor": {
      "type": "string",
      "description": "Accent/theme hex color"
    },
    "smartsiteId": {
      "type": "string",
      "description": "Specific SmartSite id (default: primary)"
    },
    "headerFormat": {
      "enum": [
        "centered",
        "left",
        "cover",
        "hero",
        "orbit",
        "card",
        "bar"
      ],
      "type": "string",
      "description": "Header layout style"
    },
    "backgroundImg": {
      "type": "string",
      "format": "uri",
      "description": "Background/wallpaper image URL"
    },
    "backgroundColor": {
      "type": "string",
      "description": "Solid background hex, e.g. \"#0b0b0f\""
    },
    "backgroundGradient": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 8,
      "description": "Gradient hex stops, e.g. [\"#5b3df5\",\"#0b0b0f\"] (clears the solid color)"
    }
  },
  "additionalProperties": false
}
swop_update_my_smartsite annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_add_link — Add a link to my SmartSite
Advertised by the server during the last successful anonymous check.

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 + previews and ask which they want. (2) call again with the same url plus displayAs = 'icon' | 'button' | 'infobar' to place it. You can override title / buttonName / description / style ('solid' | 'glass') for an info bar. Returns a viewUrl to preview the result.

swop_add_link input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "The link to add (any URL, or mailto:/tel:)"
    },
    "style": {
      "enum": [
        "solid",
        "glass"
      ],
      "type": "string",
      "description": "Info-bar card style (default solid)"
    },
    "title": {
      "type": "string",
      "maxLength": 120,
      "description": "Override the label/title"
    },
    "displayAs": {
      "enum": [
        "icon",
        "button",
        "infobar"
      ],
      "type": "string",
      "description": "Omit first to get a placement suggestion; then set to place it"
    },
    "buttonName": {
      "type": "string",
      "maxLength": 40,
      "description": "Info-bar button text (e.g. \"Pay\", \"Book\")"
    },
    "description": {
      "type": "string",
      "maxLength": 300,
      "description": "Info-bar description line"
    },
    "smartsiteId": {
      "type": "string",
      "description": "Specific SmartSite id (default: primary)"
    }
  },
  "additionalProperties": false
}
swop_add_link annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_remove_link — Remove a SmartSite link
Advertised by the server during the last successful anonymous check.
Advertised destructive

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.

swop_remove_link input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "contentType",
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "The item id from swop_get_my_smartsite"
    },
    "contentType": {
      "enum": [
        "socialTop",
        "socialLarge",
        "infoBar",
        "marketPlace"
      ],
      "type": "string",
      "description": "The kind of item to remove"
    },
    "smartsiteId": {
      "type": "string",
      "description": "Specific SmartSite id (default: primary)"
    }
  },
  "additionalProperties": false
}
swop_remove_link annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}
swop_create_feed_post — Post to my Swop feed
Advertised by the server during the last successful anonymous check.
Open-world

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 caption, the hosted image URLs and a previewId. Show the user that exact caption and every image and get an explicit yes. Then call again with the SAME caption and smartsiteId, the `images` array exactly as the preview returned it, the previewId, and confirm: true. Any change after the preview is refused — preview again. Each preview publishes at most once: re-confirming it returns the same post (duplicate: true). Never confirm before the user has seen the preview.

swop_create_feed_post input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "images": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 4,
      "description": "Images: https URLs, data:image/...;base64 URIs, or base64. On confirm, pass the hosted URLs from the preview"
    },
    "caption": {
      "type": "string",
      "maxLength": 2000,
      "description": "Post text. Hashtags and @handle.swop.id mentions work as in the app"
    },
    "confirm": {
      "type": "boolean",
      "description": "true ONLY after the user explicitly approved the preview"
    },
    "previewId": {
      "type": "string",
      "description": "From the preview step"
    },
    "smartsiteId": {
      "type": "string",
      "description": "Post as this SmartSite (default: primary). Ids from swop_get_my_profile"
    }
  },
  "additionalProperties": false
}
swop_create_feed_post annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}
swop_create_product — Create a product
Advertised by the server during the last successful anonymous check.

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. Then call swop_feature_product to show it on the SmartSite and swop_get_product_link to share it.

swop_create_product input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "description",
    "priceUsd",
    "image"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "Product name"
    },
    "image": {
      "type": "string",
      "format": "uri",
      "description": "Primary product image URL (required)"
    },
    "nftType": {
      "enum": [
        "phygital",
        "menu",
        "collectible",
        "subscription",
        "membership",
        "coupon"
      ],
      "type": "string",
      "description": "Fine-grained type; overrides productType. phygital/menu are physical, the rest digital"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Search keywords"
    },
    "priceUsd": {
      "type": "number",
      "description": "Price in USD (settles in USDC)",
      "exclusiveMinimum": 0
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "options"
        ],
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Variant group, e.g. \"Color\" or \"Size\""
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Choices, e.g. [\"Black\",\"White\"]"
          }
        },
        "additionalProperties": false
      },
      "description": "Buyer-selectable options. Replaces the existing set when given."
    },
    "mintLimit": {
      "type": "integer",
      "description": "Inventory available, default 1",
      "exclusiveMinimum": 0
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "Product description (required)"
    },
    "extraImages": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 9,
      "description": "Additional image URLs, shown after the primary one"
    },
    "productType": {
      "enum": [
        "physical",
        "digital",
        "in_person_checkout"
      ],
      "type": "string",
      "description": "physical (ships), digital (default), or in_person_checkout"
    },
    "shippingCost": {
      "type": "number",
      "minimum": 0,
      "description": "Flat shipping cost in USD"
    },
    "requiresShipping": {
      "type": "boolean",
      "description": "Physical goods: collect a shipping address"
    },
    "royaltyRecipient": {
      "type": "string",
      "description": "Wallet receiving royalties"
    },
    "royaltyPercentage": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Resale royalty percent"
    },
    "digitalDeliveryNote": {
      "type": "string",
      "maxLength": 500,
      "description": "Digital goods: what the buyer receives after purchase"
    }
  },
  "additionalProperties": false
}
swop_create_product annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_create_checkout — Create a checkout for a cart
Advertised by the server during the last successful anonymous check.

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 buyer's name, email and delivery address are REQUIRED (the call is refused otherwise, naming what is missing). Rails: USDC on Solana always; set offerCard when the seller is card-enabled and every item is a physical good — then the response has cardOffered: true and paymentRequest is null until the buyer picks a rail on the seller's page via the public URLs POST /api/v5/checkout-intents/{intentId}/card-payment-intents (Stripe client secret for a Payment Element) or POST .../select-crypto (publishes the Solana Pay request). Otherwise paymentRequest is returned at once (a solana: URL the buyer's wallet opens, also fine as a QR code). Settlement is automatic once the payment lands — nothing to confirm; poll swop_get_checkout for status. Show the buyer the products, quantities and total before creating.

swop_create_checkout input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "productId",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "description": "How many",
            "exclusiveMinimum": 0
          },
          "productId": {
            "type": "string",
            "description": "Product id from swop_list_my_products"
          },
          "selectedOptions": {
            "type": "object",
            "description": "Chosen variants, e.g. { \"Color\": \"Black\" }",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "The cart. Ids only — prices come from the catalogue"
    },
    "buyerName": {
      "type": "string",
      "maxLength": 120,
      "description": "Buyer's name (required for physical items)"
    },
    "offerCard": {
      "type": "boolean",
      "description": "Offer card as well as USDC. Only takes effect when the seller is card-enabled and every item is physical; otherwise the checkout is USDC-only"
    },
    "buyerEmail": {
      "type": "string",
      "format": "email",
      "description": "Buyer's email, for the receipt (required for physical items)"
    },
    "buyerPhone": {
      "type": "string",
      "maxLength": 60,
      "description": "Buyer's phone, for the courier"
    },
    "description": {
      "type": "string",
      "maxLength": 200,
      "description": "What this checkout is for"
    },
    "shippingAddress": {
      "type": "object",
      "required": [
        "line1",
        "city",
        "postalCode",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 120
        },
        "line1": {
          "type": "string",
          "maxLength": 180
        },
        "line2": {
          "type": "string",
          "maxLength": 180
        },
        "state": {
          "type": "string",
          "maxLength": 80
        },
        "country": {
          "type": "string",
          "maxLength": 80
        },
        "postalCode": {
          "type": "string",
          "maxLength": 40
        }
      },
      "description": "Delivery address. Required when any item is a physical product",
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
swop_create_checkout annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_get_checkout — Check a checkout
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

swop_get_checkout input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "intentId"
  ],
  "properties": {
    "intentId": {
      "type": "string",
      "pattern": "^co_[A-Za-z0-9_-]{4,40}$",
      "description": "The intentId returned by swop_create_checkout"
    }
  },
  "additionalProperties": false
}
swop_get_checkout annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
swop_list_webhooks — List my webhooks
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_list_webhooks input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_list_webhooks annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
swop_register_webhook — Add a webhook
Advertised by the server during the last successful anonymous check.

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>; failed deliveries retry for about 15 hours. Confirm the exact URL with the user first.

swop_register_webhook input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2000,
      "description": "https URL to POST events to (http allowed for localhost only)"
    },
    "label": {
      "type": "string",
      "maxLength": 80,
      "description": "A name for this endpoint"
    },
    "events": {
      "type": "array",
      "items": {
        "enum": [
          "checkout.paid",
          "payout.released"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Which events to send. Default: both"
    }
  },
  "additionalProperties": false
}
swop_register_webhook annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_test_webhook — Send a test event to a webhook
Advertised by the server during the last successful anonymous check.
Open-world

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.

swop_test_webhook input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Webhook id from swop_list_webhooks"
    }
  },
  "additionalProperties": false
}
swop_test_webhook annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "destructiveHint": false
}
swop_remove_webhook — Remove a webhook
Advertised by the server during the last successful anonymous check.
Advertised destructive

Stop sending events to one of the linked account's webhook URLs. Pending deliveries to it are dropped. Confirm with the user first.

swop_remove_webhook input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Webhook id from swop_list_webhooks"
    }
  },
  "additionalProperties": false
}
swop_remove_webhook annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}
swop_list_embed_origins — List sites allowed to frame my checkout
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

swop_list_embed_origins input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_list_embed_origins annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
swop_register_embed_origin — Allow a site to frame my checkout
Advertised by the server during the last successful anonymous check.

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.

swop_register_embed_origin input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "origin"
  ],
  "properties": {
    "label": {
      "type": "string",
      "maxLength": 80,
      "description": "A note to recognise it later"
    },
    "origin": {
      "type": "string",
      "minLength": 1,
      "description": "Bare origin, e.g. https://acme.com"
    }
  },
  "additionalProperties": false
}
swop_register_embed_origin annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_remove_embed_origin — Stop a site framing my checkout
Advertised by the server during the last successful anonymous check.
Advertised destructive

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.

swop_remove_embed_origin input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "Origin id from swop_list_embed_origins"
    }
  },
  "additionalProperties": false
}
swop_remove_embed_origin annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}
swop_feature_product — Feature a product on my SmartSite
Advertised by the server during the last successful anonymous check.

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.

swop_feature_product input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "templateId"
  ],
  "properties": {
    "templateId": {
      "type": "string",
      "description": "The product/template id from swop_create_product"
    },
    "smartsiteId": {
      "type": "string",
      "description": "Specific SmartSite id (default: primary)"
    },
    "carouselTitle": {
      "type": "string",
      "maxLength": 80,
      "description": "Optional heading for the product section"
    }
  },
  "additionalProperties": false
}
swop_feature_product annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_list_my_products — List my products
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

swop_list_my_products input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
swop_list_my_products annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
swop_update_product — Update or unlist a product
Advertised by the server during the last successful anonymous check.
Advertised destructive

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.

swop_update_product input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "productId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "New product name"
    },
    "image": {
      "type": "string",
      "format": "uri",
      "description": "New primary image URL"
    },
    "status": {
      "enum": [
        "active",
        "archived"
      ],
      "type": "string",
      "description": "Set 'archived' to unlist"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "description": "Replaces the keywords"
    },
    "priceUsd": {
      "type": "number",
      "description": "New price in USD (settles in USDC)",
      "exclusiveMinimum": 0
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "options"
        ],
        "properties": {
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Variant group, e.g. \"Color\" or \"Size\""
          },
          "options": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Choices, e.g. [\"Black\",\"White\"]"
          }
        },
        "additionalProperties": false
      },
      "description": "Buyer-selectable options. Replaces the existing set when given."
    },
    "mintLimit": {
      "type": "integer",
      "description": "New inventory available",
      "exclusiveMinimum": 0
    },
    "productId": {
      "type": "string",
      "description": "The product id from swop_list_my_products"
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "New description"
    },
    "extraImages": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      },
      "maxItems": 9,
      "description": "Replaces the additional images. Requires image, since the full list is rewritten"
    },
    "shippingCost": {
      "type": "number",
      "minimum": 0,
      "description": "Flat shipping cost in USD"
    },
    "requiresShipping": {
      "type": "boolean",
      "description": "Collect a shipping address"
    },
    "royaltyRecipient": {
      "type": "string",
      "description": "Wallet receiving royalties"
    },
    "royaltyPercentage": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Resale royalty percent"
    },
    "digitalDeliveryNote": {
      "type": "string",
      "maxLength": 500,
      "description": "What a buyer receives"
    }
  },
  "additionalProperties": false
}
swop_update_product annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": true
}
swop_get_product_link — Get a shareable product link
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

swop_get_product_link input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "handle",
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "minLength": 1,
      "description": "Product sku/id from swop_get_store"
    },
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "Seller swop.id, e.g. \"travis.swop.id\""
    }
  },
  "additionalProperties": false
}
swop_get_product_link annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}
swop_get_store — Get a swop.id storefront
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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 with a signed X-PAYMENT header completes the purchase and returns a receipt. Always show the user the product, price, and seller and get their confirmation before paying.

swop_get_store input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "handle"
  ],
  "properties": {
    "handle": {
      "type": "string",
      "minLength": 1,
      "description": "The seller swop.id, e.g. \"travis.swop.id\""
    }
  },
  "additionalProperties": false
}
swop_get_store annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
449 ms
95th percentile latency
449 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 449 ms · metadata changed · 27 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http swop-mcp https://mcp.swopme.co/mcp/commerce

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add swop-mcp --url https://mcp.swopme.co/mcp/commerce

Cursor

Merge this server into .cursor/mcp.json in your project, then enable swop-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "swop-mcp": {
      "url": "https://mcp.swopme.co/mcp/commerce"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "swop-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.swopme.co/mcp/commerce",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start swop-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "swop-mcp": {
      "type": "http",
      "url": "https://mcp.swopme.co/mcp/commerce"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http swop-mcp https://mcp.swopme.co/mcp/commerce

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://mcp.swopme.co/mcp/commerce

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "swop-mcp": {
      "serverUrl": "https://mcp.swopme.co/mcp/commerce"
    }
  }
}

Let your agent find its tools

Find servers like Swop MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,474