Search / io.github.Travisswop/swop
swop
R0· no sign-inSell to people and AI agents: create products, a storefront, and USDC payment links from chat.
v0.2.1 · active · repository · descriptor JSON · versions
Search / io.github.Travisswop/swop
R0· no sign-inSell to people and AI agents: create products, a storefront, and USDC payment links from chat.
v0.2.1 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"swop": {
"type": "http",
"url": "https://mcp.swopme.co/mcp/commerce"
}
}
}claude mcp add --transport http swop https://mcp.swopme.co/mcp/commerce[mcp_servers.swop]
url = "https://mcp.swopme.co/mcp/commerce"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"swop": {
"type": "remote",
"url": "https://mcp.swopme.co/mcp/commerce",
"enabled": true
}
}
}{
"mcpServers": {
"swop": {
"type": "http",
"url": "https://mcp.swopme.co/mcp/commerce"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=swop&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnN3b3BtZS5jby9tY3AvY29tbWVyY2UifQ%3D%3D"
}{
"servers": {
"swop": {
"type": "http",
"url": "https://mcp.swopme.co/mcp/commerce"
}
}
}{
"mcpServers": {
"swop": {
"httpUrl": "https://mcp.swopme.co/mcp/commerce"
}
}
}extensions:
"swop":
enabled: true
name: "swop"
type: streamable_http
uri: "https://mcp.swopme.co/mcp/commerce"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations42 of 42 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: swop_list_my_products (idempotentHint); swop_get_orderbook (idempotentHint); swop_check_predictions_access (idempotentHint); …tools.token_costabout 9,126 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes26 tool changes in 30 daysstability.rug_pull3 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageswop_get_helpchangeddescriptionLook 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 how a Swop 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.
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_feature_productchangeddescriptionShow 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).
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_get_my_profilechangeddescriptionmeaning changedThe linked Swop account: name, email, and SmartSites (handle, bio). Requires connecting your Swop account.
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_helpchangeddescription, input schemameaning changedCurated Swop instructions for payment previews, funded claim links, Goldman AI credits, companion pairing and optional saved context.
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 how a Swop 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_helpaddedCurated Swop instructions for payment previews, funded claim links, Goldman AI credits, companion pairing and optional saved context.
swop_get_storechangeddescriptionSee what any swop.id sells and buy it. List the real products a swop.id sells on their SmartSite, with USDC prices and each product's x402 buyUrl. 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.
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_list_my_productschangeddescriptionList the linked account's products (each with its id, name, price, inventory, and status). Use the id with swop_update_product (to edit or unlist) or swop_feature_product (to show it on the SmartSite).
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_feature_productchangeddescriptionmeaning changedMake a product visible on the user's SmartSite as a product tile visitors can buy from. Put an already-created product (from swop_create_product) onto the SmartSite as a visible product tile so visitors see and can buy it. Pass the product's templateId (returned by swop_create_product). Use swop_create_product first to make the product, then this to display it.
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).
swop_create_checkoutchangeddescriptionTake payment on the seller's own website: creates a real Swop checkout for a cart of their products and returns a payment request (Solana Pay URL / QR, or card when enabled); settlement and payout are automatic. Create a real Swop checkout for a cart of the linked account's OWN products, so a buyer pays on the seller's own website instead of being sent to Swop. 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.
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_productchangeddescriptionStart 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. It becomes instantly purchasable by humans at the SmartSite and by AI agents over x402. 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.
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.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +reachable +uptime-100% +updated-18d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://mcp.swopme.co/mcp/commerce streamable-http | none | yes | 100% | 395 ms | 2025-11-25 | 2026-10-19 |
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 + 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_check_predictions_accessread-only | Check whether prediction-market trading is available (geo-restrictions apply in some regions). Call before suggesting trading actions; market DATA tools work everywhere. |
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 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_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 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_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. Then call swop_feature_product to show it on the SmartSite and swop_get_product_link to share it. |
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. |
swop_get_checkoutread-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_event_live_statusread-only | Check whether an event (e.g. a game) is live, its current period and elapsed time, and whether it has closed. Never infer live status from the clock — use this. |
swop_get_event_marketsread-only | Fetch every market for a single event by event slug — moneyline plus alternate spread/total lines and player props for sports, or all outcomes for multi-outcome events. Use after swop_search_markets when the user wants full detail on one game/event. |
swop_get_helpread-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_my_balancesread-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_ordersread-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_profileread-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_smartsiteread-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_orderbookread-only | Fetch the live CLOB orderbook (bids/asks) for one outcome token of a prediction market. Token ids come from the clobTokenIds field of market results. |
swop_get_price_historyread-only | Historical price series for one outcome token. Interval controls the window (e.g. "1d", "1w", "1m", "max"); fidelity is the candle resolution in minutes. |
swop_get_pricesread-only | Batch-fetch current best prices for up to 50 outcome token ids. Returns live book-derived prices (0..1 probabilities). Prefer this over the outcomePrices field on market rows when freshness matters — cached market rows can lag the book. |
swop_get_product_linkread-only | 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_spending_delegationread-only | The linked account's transaction delegation for AI assistants: whether it's active, per-transaction and daily caps, and how much of today's cap is already spent. Check before attempting a send. |
swop_get_storeread-only | 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_swap_quoteread-only | Get a swap quote for the linked user — EVM (via LiFi) or Solana (via Jupiter). Read-only: returns the estimated output and directs the user to complete the swap in the Swop app. For EVM, pass chain plus token ADDRESSES; for Solana, omit chain and pass token MINTS. Amounts are in the input token's base units. |
swop_get_taxonomyread-only | Canonical mapping of sports and categories to tag ids, for use as tag_id in swop_search_markets. Also see swop_get_taxonomy_stats for open volume and live-game counts per sport. |
swop_get_taxonomy_statsread-only | Open volume and live-event counts per sport/category — useful for "what is popular right now". |
swop_list_embed_originsread-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_my_productsread-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_tokensread-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_webhooksread-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_lookup_identityread-only | 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_pay_x402_linkdestructive | Pay an external x402 payment link (any https URL that returns an HTTP 402 USDC challenge) from the linked user's Swop wallet, within their caps. TWO-STEP like swop_send: call WITHOUT confirm to preview (amount, payee, host, caps), show it to the user and get their explicit yes, then call again with the returned previewId and confirm: true. Over-cap or no delegation returns a Swop-app approval link. Base USDC only. |
swop_perps_orderdestructive | Open or close a Hyperliquid perpetual position for the linked user, within their margin and leverage caps set in the Swop app. The cap is MARGIN per position (e.g. $25) with a leverage ceiling (e.g. 5x) — so $25 at 5x controls ~$125 of exposure. TWO-STEP like swop_send: call WITHOUT confirm to preview (coin, direction, margin, leverage, resulting exposure, mark price); ALWAYS show the user the leverage and exposure and get explicit confirmation; then call again with previewId and confirm: true. reduceOnly:true closes/reduces an existing position. Over-cap or no delegation returns a Swop-app approval link. Perps are leveraged and can be liquidated — make the risk clear to the user. |
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. |
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>; failed deliveries retry for about 15 hours. Confirm the exact URL with the user first. |
swop_remove_embed_origindestructive | 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_linkdestructive | 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_webhookdestructive | Stop sending events to one of the linked account's webhook URLs. Pending deliveries to it are dropped. Confirm with the user first. |
swop_search_identitiesread-only | 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_marketsread-only | Search Swop prediction markets (Polymarket-backed) by topic. Supports free-text search over question/event/outcomes/tags, plus live-game and sport filters. Returns market question, slug, outcomes with current prices, CLOB token ids, liquidity, and end date. Prices are 0..1 probabilities per outcome. |
swop_senddestructive | Send USDC (on Base) from the linked Swop wallet to a swop.id handle or 0x address, within the caps the user set in the Swop app. TWO-STEP: call WITHOUT confirm first to get a preview (resolved recipient, amount, caps); show that summary to the user and get their explicit yes; then call again with the returned previewId and confirm: true. Over-cap or confirm-only settings return a Swop-app approval link instead of executing. Never call with confirm before the user has seen the preview. |
swop_swapdestructive | Execute an on-chain token swap from the linked user's Swop wallet, within their delegation caps. EVM only (via LiFi); Solana swaps still complete in the app. TWO-STEP like swop_send: call WITHOUT confirm to preview (estimated output, min received, USD value, caps); show the user the estimated output and get their explicit yes; then call again with the returned previewId and confirm: true. Gas is sponsored, and any needed token approval is handled automatically. Over-cap or no delegation returns a Swop-app approval link. Pass chain plus token ADDRESSES; amount is in the input token's base units. |
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. |
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. |
swop_update_productdestructive | 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. |
Schemas: list_tools.
{
"name": "io.github.Travisswop/swop",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://mcp.swopme.co/mcp/commerce",
"type": "streamable-http"
}
],
"version": "0.2.1",
"repository": {
"url": "https://github.com/Travisswop/swop-mcp",
"source": "github"
},
"description": "Sell to people and AI agents: create products, a storefront, and USDC payment links from chat."
}