Store Management via AI#

This skill teaches AI agents how to manage a Mobazha store using MCP tools. It requires a working MCP connection — see store-mcp-connect skill first.

Product Management#

List All Products#

text

Tool: listings_list_mine
Parameters: (none)

Returns all listings owned by the authenticated seller, including title, price, stock, status.

Get Product Details#

text

Tool: listings_get
Parameters:
  slug_or_cid: "my-product-slug"   (required)

Create a Product#

First, get the listing template to see all available fields:

text

Tool: listings_get_template
Parameters: (none)

Then create the listing:

text

Tool: listings_create
Parameters:
  listing_json: '{"title":"...", "description":"...", "price":29.99, ...}'   (required)

The listing_json should include at minimum: title, description, price, priceCurrency, quantity, condition, listingType.

Update a Product#

text

Tool: listings_update
Parameters:
  listing_json: '{"slug":"existing-slug", "title":"Updated Title", ...}'   (required)

Include the slug to identify which listing to update.

Delete a Product#

text

Tool: listings_delete
Parameters:
  slug: "my-product-slug"   (required)

Typical "Add Product" Workflow#

When a seller says "add a product," follow this sequence:

1. Ask for: product name, description, price, currency, stock quantity
2. Ask for product images (or accept URLs to download)
3. Call listings_get_template to get the full schema
4. Fill in the template with provided values
5. Call listings_create with the JSON
6. Confirm success and share the listing URL

Order Management#

View Sales (Seller Perspective)#

text

Tool: orders_get_sales
Parameters:
  limit: "20"    (optional, default varies)
  offset: "0"    (optional)

View Purchases (Buyer Perspective)#

text

Tool: orders_get_purchases
Parameters:
  limit: "20"    (optional)
  offset: "0"    (optional)

Get Order Details#

text

Tool: orders_get_detail
Parameters:
  order_id: "QmXyz..."   (required)

Order Lifecycle Actions#

ActionToolWhen to UseConfirmorders_confirmAccept an incoming orderDeclineorders_declineReject an orderFulfillorders_fulfillMark as shipped, add trackingCompleteorders_completeRelease escrow fundsRefundorders_refundIssue a refundCancelorders_cancelCancel as buyer

Fulfill with tracking info:

text

Tool: orders_fulfill
Parameters:
  order_id: "QmXyz..."            (required)
  shipper: "FedEx"                (optional)
  tracking_number: "123456789"    (optional)
  note: "Shipped via express"     (optional)

Typical "Process New Orders" Workflow#

When a seller says "check my orders":

1. Call orders_get_sales to list recent orders
2. Summarize: how many new/pending, total revenue
3. For each pending order, ask if the seller wants to confirm or decline
4. After confirming, ask if they have tracking info to fulfill

Buyer Communication#

List Conversations#

text

Tool: chat_get_conversations
Parameters: (none)

Read Messages#

text

Tool: chat_get_messages
Parameters:
  room_id: "!abc:matrix.org"    (use room_id or peer_id)
  peer_id: "QmPeerID..."        (alternative to room_id)
  limit: "20"                   (optional)

Send a Message#

text

Tool: chat_send_message
Parameters:
  message: "Thanks for your order!"    (required)
  room_id: "!abc:matrix.org"           (use room_id or peer_id)
  peer_id: "QmPeerID..."              (alternative)
  order_id: "QmOrderID..."            (optional, links message to order)

Typical "Reply to Buyers" Workflow#

1. Call chat_get_conversations to see active chats
2. For conversations with unread messages, call chat_get_messages
3. Summarize buyer questions for the seller
4. Draft replies based on seller's instructions
5. Send via chat_send_message after seller approval

Discounts and Promotions#

List Discounts#

text

Tool: discounts_list
Parameters: (none)

Create a Discount#

text

Tool: discounts_create
Parameters:
  discount_json: '{"title":"Summer Sale", "discountType":"PERCENTAGE", "value":20, ...}'   (required)

Update / Delete#

text

Tool: discounts_update
Parameters:
  discount_id: "abc123"         (required)
  discount_json: '{"value":25}'  (required)

Tool: discounts_delete
Parameters:
  discount_id: "abc123"   (required)

Collections#

List Collections#

text

Tool: collections_list
Parameters: (none)

Create a Collection#

text

Tool: collections_create
Parameters:
  collection_json: '{"name":"Best Sellers", "description":"Our top products"}'   (required)

Add Products to Collection#

text

Tool: collections_add_products
Parameters:
  collection_id: "abc123"                              (required)
  products_json: '["product-slug-1","product-slug-2"]'  (required)

Store Profile#

View Profile#

text

Tool: profile_get
Parameters: (none)

Update Profile#

text

Tool: profile_update
Parameters:
  profile_json: '{"name":"Updated Store Name", "shortDescription":"New tagline"}'   (required)

Settings#

View Storefront Settings#

text

Tool: settings_get_storefront
Parameters: (none)

Returns storefront configuration including accepted currencies, shipping options, return policy, terms of service, and store appearance settings.

Notifications#

Check Notifications#

text

Tool: notifications_list
Parameters:
  limit: "10"    (optional)
  offset: "0"    (optional)

Unread Count#

text

Tool: notifications_unread_count
Parameters: (none)

Mark as Read#

text

Tool: notifications_mark_read
Parameters:
  notification_id: "abc123"   (required)

Finance and Rates#

Exchange Rates#

text

Tool: exchange_rates_get
Parameters:
  currency: "USD"   (optional, returns all if omitted)

Receiving Addresses (Crypto Wallets)#

text

Tool: wallet_get_receiving_accounts
Parameters: (none)

Returns the external wallet addresses configured for receiving payments.

Fiat Payment Providers#

text

Tool: fiat_get_providers
Parameters: (none)

Tool: fiat_get_provider_config
Parameters:
  provider_id: "stripe"   (required)

Marketplace Search#

These tools search the public marketplace, not just your store. Useful for market research.

Search Listings#

text

Tool: search_listings
Parameters:
  query: "vintage watches"    (optional)
  page: "1"                   (optional)
  pageSize: "20"              (optional)
  sortBy: "relevance"         (optional)

Search Seller Profiles#

text

Tool: search_profiles
Parameters:
  query: "electronics"   (optional)
  page: "1"              (optional)
  pageSize: "20"         (optional)

Note: Search tools are only available when the MCP server was started with --search-url configured.

Best Practices for AI Agents#

1. Always confirm before destructive actions — deleting products, declining orders, issuing refunds
2. Ask for explicit user consent before initiating any MCP connection or executing store operations
3. Summarize before acting — show the seller what you found before making changes
4. Batch intelligently — process multiple orders or products in sequence, reporting progress
5. Use templates — call listings_get_template before creating products to ensure valid JSON
6. Respect rate limits — space out rapid consecutive calls
7. Never log or display tokens — MCP credentials must not appear in agent output or logs