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

Account & lookups

The signed-in user’s profile, balances, orders and launched tokens, plus verified prices, sports data and help.

7 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_get_my_profile

Get my Swop profile · Sign-in: profile.read · /mcp and /mcp/commerce · 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.

No inputs.

swop_get_my_balances

Get my wallet balances · Sign-in: wallet.read · /mcp and /mcp/commerce · 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.

No inputs.

swop_get_my_orders

Get my orders · Sign-in: wallet.read · /mcp and /mcp/commerce · 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.

No inputs.

swop_list_my_tokens

List my Launchpad tokens · Sign-in: wallet.read · /mcp and /mcp/commerce · 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.

No inputs.

swop_get_token_price

Swop token price · Sign-in: profile.read · /mcp only · Read-only

Verified live token spot price with provider timestamp and exact network/contract identity. Pass a symbol or exact contract; ambiguous names require clarification. Read only, no trade or AI-credit charge.

InputTypeRequiredDescription
tokenstringYesmin length 1; max length 100
addressstringNomax length 120
chainstringNomax length 30

swop_get_sports

Swop sports · Sign-in: profile.read · /mcp only · Read-only

Verified sports scores, schedules, statistics and available odds. UNCC means Charlotte 49ers. Use NCAA for an ambiguous college matchup, NCAAF for college football, NCAAB for college basketball. Preserve requested dates in query. No betting or trade execution.

InputTypeRequiredDescription
querystringYesmin length 1; max length 240
leaguestringNomax length 30
topic"scoreboard" | "odds" | "stats" | "injuries" | "props"No
teamsarray of stringNomax items 2

swop_get_help

Swop help · Sign-in: profile.read · /mcp and /mcp/commerce · 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.

InputTypeRequiredDescription
querystringYesThe question in plain words, e.g. "how do claim links work" or "what are Goldman credits". Max 240 characters. (max length 240)

On this page