promua-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SEARXNG_URL | No | Optional SearXNG URL for external search fallback. | |
| BRAVE_API_KEY | No | Optional Brave API key for external search fallback. | |
| PROM_DATA_DIR | No | Directory for local saved searches data. | |
| PROM_API_TOKEN | No | Prom.ua API token for seller tools. Optional; required only for seller API operations. | |
| PROM_ALLOW_WRITES | No | Set to 'true' to enable seller write operations. Writes are disabled by default. | false |
| PROM_API_BASE_URL | No | Base URL for the Prom.ua seller API. | https://my.prom.ua/api/v1 |
| PROM_HTTP_TIMEOUT_MS | No | HTTP timeout in milliseconds. | 15000 |
| PROM_SAVED_SEARCHES_FILE | No | File path for local saved searches persistence. |
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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| prom_search_productsB | Search Prom.ua directly via its public SSR search page and Product JSON-LD. Falls back to DuckDuckGo HTML search if direct Prom parsing fails. |
| prom_saved_search_listB | List locally saved Prom.ua searches. |
| prom_saved_search_createC | Save a structured Prom.ua search definition locally for repeat execution. |
| prom_saved_search_deleteC | Delete a locally saved Prom.ua search. |
| prom_saved_search_runB | Run a locally saved Prom.ua search using direct Prom SSR with DuckDuckGo fallback. |
| prom_search_urlA | Build a Prom.ua marketplace search URL for a query. Requires no API credentials and performs no automated page access. |
| prom_seller_list_productsC | List products from the authenticated seller's Prom.ua company via Public API. |
| prom_seller_get_productB | Get one seller product by Prom.ua product id. |
| prom_seller_get_product_by_external_idB | Get one seller product by external id. |
| prom_seller_edit_productsB | Edit seller products by Prom.ua ids. Disabled unless PROM_ALLOW_WRITES=true. |
| prom_seller_edit_products_by_external_idB | Edit seller products by external ids. Disabled unless PROM_ALLOW_WRITES=true. |
| prom_seller_list_ordersC | List orders from the authenticated Prom.ua seller company. |
| prom_seller_get_orderC | Get one seller order by id. |
| prom_seller_set_order_statusB | Change status for one or more seller orders. Disabled unless PROM_ALLOW_WRITES=true. |
| prom_seller_list_clientsC | List clients of the authenticated Prom.ua seller company. |
| prom_seller_get_clientC | Get one seller client by id. |
| prom_seller_list_messagesC | List messages for the authenticated Prom.ua seller company. |
| prom_seller_get_messageC | Get one seller message by id. |
| prom_seller_set_message_statusC | Change status for one or more seller messages. Disabled unless PROM_ALLOW_WRITES=true. |
| prom_seller_reply_messageB | Reply to a seller message through Prom.ua. Disabled unless PROM_ALLOW_WRITES=true. |
| prom_seller_list_groupsC | List seller product groups. |
| prom_seller_list_payment_optionsB | List seller payment options. |
| prom_seller_list_delivery_optionsB | List seller delivery options. |
| prom_seller_list_order_status_optionsC | List seller order status options. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Most tools target distinct resource+action pairs, and the by-id vs by-external-id pairs are clarified in their descriptions. Minor overlap remains between prom_search_products and prom_saved_search_run (both execute searches with the same fallback), which could cause slight misselection.
Strong, predictable prom_<domain>_<verb>_<noun> snake_case pattern across the set. A few tools (prom_search_url, prom_search_products) use 'search' as a verb while seller tools use list/get/edit/set, causing minor inconsistency but still readable.
24 tools is on the heavy side and includes granular duplication such as separate by-id and by-external-id get/edit variants plus multiple option-list tools. The breadth is partly justified by the seller/public-search split, but the surface feels padded.
Read coverage is strong, but write/lifecycle operations are uneven: products support edit but not create or delete, clients and groups are list/get-only, and messages lack deletion. These notable gaps will force agents to work around missing CRUD operations.