# Identity & stores (/docs/mcp/tool-reference/identity-and-stores)

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` [#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.

| Input | Type | Required | Description |
|---|---|---|---|
| `query` | `string` | Yes | Handle or name fragment, at least 2 characters (e.g. "travis") (min length 2) |
| `limit` | `integer` | No | Max results, default 8 (min 1; max 20) |

## `swop_lookup_identity` [#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.

| Input | Type | Required | Description |
|---|---|---|---|
| `handle` | `string` | Yes | Exact swop.id handle, e.g. "travis.swop.id" (min length 1) |

## `swop_get_store` [#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.

| Input | Type | Required | Description |
|---|---|---|---|
| `handle` | `string` | Yes | The seller swop.id, e.g. "travis.swop.id" (min length 1) |

## `swop_get_product_link` [#swop_get_product_link]

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

| Input | Type | Required | Description |
|---|---|---|---|
| `handle` | `string` | Yes | Seller swop.id, e.g. "travis.swop.id" (min length 1) |
| `sku` | `string` | Yes | Product sku/id from swop_get_store (min length 1) |
