Skip to main content
Glama
asgard-ai-platform

mcp-buy123-vendor

by asgard-ai-platform
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_abnormal_ordersC

列出異常訂單 (GET /v1/abnormal-orders).

get_current_userA

取得目前登入供應商使用者的資訊 (GET /v1/auth/me).

get_my_menuC

取得供應商使用者選單 (GET /v1/auth/me/menu).

auth_statusA

Report whether the MCP currently has a usable vendor access token.

Call this before other tools if you're unsure whether login is needed. Does NOT hit the upstream API — purely a local cache check.

vendor_loginA

Open a real Chromium window so the user can log in to the vendor frontend.

Use this when:

  • auth_status reports authenticated=false

  • Another tool has returned a "No vendor access token" / "token refresh failed" error

Flow:

  1. A Chromium window opens at the vendor frontend.

  2. Email / password / vendor_id are best-effort prefilled from env.

  3. The user solves the reCAPTCHA and clicks submit themselves.

  4. This tool captures the POST /v1/auth/login response, updates the in-memory cache, and writes VENDOR_ACCESS_TOKEN / VENDOR_REFRESH_TOKEN back to .env so future MCP restarts are also authenticated.

Blocks until the user completes the login (up to 10 minutes) or aborts.

list_bundlesC

取得商品方案列表 (GET /v1/bundles).

get_bundleB

檢視指定方案 (GET /v1/bundles/{bundle_id}).

list_bundle_itemsC

取得方案商品選項列表 (GET /v1/bundles/{bundle_id}/items).

get_bundle_itemA

取得單一方案商品選項 (GET /v1/bundles/{bundle_id}/items/{item_id}).

list_pricing_channelsA

取得方案價格渠道列表 (GET /v1/bundles/pricing-channels).

list_channelsC

渠道列表 (GET /v1/channels).

list_channel_productsC

渠道商品列表 (GET /v1/channel-products).

list_banksB

獲取銀行列表 (GET /v1/common/banks).

list_bundle_typesA

獲取方案類型列表 (GET /v1/common/bundle-type).

list_bundle_delivery_notesA

獲取方案出貨備註列表 (GET /v1/common/bundle-delivery-note).

list_bundle_delivery_statusesA

獲取方案出貨狀態列表 (GET /v1/common/bundle-delivery-status).

list_delivery_typesA

獲取出貨方式列表 (GET /v1/common/delivery-type).

list_packaging_typesB

獲取包材類型列表 (GET /v1/common/packaging-type).

list_invoice_typesA

獲取發票類型列表 (GET /v1/common/invoice-type).

list_product_statusesB

獲取商品狀態列表 (GET /v1/common/product-status).

list_event_product_statusesB

獲取活動商品狀態列表 (GET /v1/common/event-product-status).

list_gross_profit_statusesB

獲取毛利狀態列表 (GET /v1/common/gross-profit-status).

list_review_statusesA

獲取審核狀態列表 (GET /v1/common/review-status).

list_announcement_notify_levelsA

獲取公告通知等級列表 (GET /v1/common/announcement-notify-level).

list_announcement_notify_scopesA

獲取公告通知範圍列表 (GET /v1/common/announcement-notify-scope).

list_announcement_notify_typesB

獲取公告通知類型列表 (GET /v1/common/announcement-notify-type).

list_item_option_inventoriesB

取得商品選項庫存列表 (GET /v1/item-option-inventories).

list_vendor_actionsB

取得廠商權限列表 (GET /v1/vendors/actions).

list_vendor_rolesC

取得廠商角色列表 (GET /v1/vendors/roles).

list_vendor_role_actionsC

取得廠商角色權限 (GET /v1/vendors/roles/actions).

list_item_selectionA

取得商品選擇列表 (GET /v1/item-selection) — 只包含審核通過的商品，供方案選擇商品用。

list_itemsB

取得商品列表 (GET /v1/items).

get_itemA

取得商品詳細資訊 (GET /v1/items/{id}).

list_item_historyB

取得商品歷史紀錄 (GET /v1/items/{id}/history).

list_item_optionsC

取得商品選項列表 (GET /v1/items/{id}/options).

list_item_options_selectionC

取得商品選項選擇列表 (GET /v1/items/{id}/options-selection).

list_productsC

取得商品列表 (GET /v1/products).

get_productB

取得商品 (GET /v1/products/{product_id}).

list_product_annotation_logsA

取得商品註解紀錄列表 (GET /v1/products/{product_id}/annotation-logs).

list_product_bundle_pricesB

取得商品方案渠道價錢列表 (GET /v1/products/{product_id}/bundle-prices).

list_product_bundlesB

取得商品方案列表 (GET /v1/products/{product_id}/bundles).

list_product_versionsA

取得商品版本列表 (GET /v1/products/{product_id}/versions).

list_commodity_categoriesC

取得商品類別選單 (GET /v1/vendors/commodities/categories).

get_template_category_formB

取得最新版的分類題組表單 (GET /v1/vendors/commodities/template-category-form/{category_id}).

list_returnsD

退貨大表 (GET /v1/returns).

list_uncollected_cvs_returnsC

超商未取退回大表 (GET /v1/uncollected-cvs-returns).

list_shipmentsC

廠商出貨列表 (GET /v1/shipments).

list_cvs_shipment_detailsC

超取出貨明細列表 (GET /v1/shipments/cvs/details).

list_home_delivery_shipment_detailsC

宅配出貨明細列表 (GET /v1/shipments/home-delivery/details).

get_vendorB

取得廠商資訊 (GET /v1/vendors).

get_vendor_profileB

取得廠商基本資料 (GET /v1/vendors/profile).

list_vendor_attachmentsA

取得廠商上傳文件列表 (GET /v1/vendors/attachments).

檔案本體下載屬於 binary endpoint，Phase 1 未實作。

list_vendor_categoriesB

取得廠商分類列表 (GET /v1/vendors/categories).

check_vendor_tax_numberA

檢查統編是否存在 (GET /v1/vendors/check-tax-number/{tax_number}).

get_vendor_return_addressC

取得廠商退貨地址 (GET /v1/vendors/return-address).

list_vendor_store_pickup_return_dcB

獲取供應商超商退貨 DC (GET /v1/vendors/store-pickup-return-dc).

list_vendor_store_pickup_return_modeB

獲取供應商超商取貨退貨方式 (GET /v1/vendors/store-pickup-return-mode).

list_vendor_store_pickupsC

獲取超商取貨申請資料 (GET /v1/vendors/store-pickups).

get_vendor_store_pickupB

獲取供應商超商取貨申請 (GET /v1/vendors/store-pickups/{store_type}).

list_vendor_usersC

取得廠商使用者列表 (GET /v1/vendors/users).

check_vendor_user_emailB

檢查使用者 Email 是否存在 (GET /v1/vendors/check-vendor-user-email/{email}).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

C2.6/5.0

Scored across 61 tools

Disambiguation2/5

Many tools have overlapping names and concepts, such as list_product_bundles vs list_bundles, list_items vs list_products, and multiple similar list_* endpoints for different resource types. An agent can easily confuse which list to call for a given purpose.

Naming Consistency4/5

The naming convention is mostly consistent with snake_case and verb_noun pattern (list_*, get_*, check_*). Minor exceptions like auth_status and vendor_login deviate slightly but remain readable and predictable.

Tool Count2/5

With 61 tools, the server is heavily over-scoped for most use cases. Many tools simply list enum values or static configurations, which bloats the tool surface and increases selection complexity.

Completeness2/5

The toolset is almost entirely read-only (list/get/check), lacking create, update, or delete operations for core entities like products, bundles, and vendors. This creates dead ends for management workflows and limits the server's practical utility.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources