docs
Get startedTroubleshootingPaymentsWebhooksAgent paymentsSwop MCPOviIdentity (swop.id)SwivyRPC (preview)API reference
Tool reference

Identity & stores

Look people up by swop.id and browse any seller’s store. No sign-in needed.

4 tools. Generated from the Swop MCP server’s own tools/list (server version 0.2.2), so names, inputs and limits match what your client sees.

swop_search_identities

Search swop.id identities · No sign-in · /mcp and /mcp/commerce · Read-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.

InputTypeRequiredDescription
querystringYesHandle or name fragment, at least 2 characters (e.g. "travis") (min length 2)
limitintegerNoMax results, default 8 (min 1; max 20)

swop_lookup_identity

Look up a swop.id · No sign-in · /mcp and /mcp/commerce · Read-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.

InputTypeRequiredDescription
handlestringYesExact swop.id handle, e.g. "travis.swop.id" (min length 1)

swop_get_store

Get a swop.id storefront · No sign-in · /mcp and /mcp/commerce · Read-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.

InputTypeRequiredDescription
handlestringYesThe seller swop.id, e.g. "travis.swop.id" (min length 1)

Get a shareable product link · No sign-in · /mcp and /mcp/commerce · Read-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.

InputTypeRequiredDescription
handlestringYesSeller swop.id, e.g. "travis.swop.id" (min length 1)
skustringYesProduct sku/id from swop_get_store (min length 1)

On this page