Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Prom.ua in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Prom.ua seller API for Ukrainian marketplace stores: orders with buyer and delivery details, order status changes, products and product groups, clients and buyer messages. Bearer token from the seller cabinet.
Try asking
Example prompts for Prom.ua
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Prom.ua, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
Prom.ua + Gemini
Prom.ua seller API for Ukrainian marketplace stores: orders with buyer and delivery details, order status changes, products and product groups, clients and buyer messages. Bearer token from the seller cabinet.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
PROM_UA_API_TOKEN
Step 1 — Get credentials
- In the Prom.ua seller cabinet, open Settings → API token management (Налаштування → Управління API-токенами) and create a token.
- Give it access to the sections the assistant should use (orders, products, clients, messages) and paste it into
PROM_UA_API_TOKEN. A token only sees the company it was created for; a wrong or revoked token is answered with HTTP 401. - Start with
prom_ua_list_orders(filter by status or dates), thenprom_ua_get_orderfor the buyer, delivery and items.prom_ua_list_order_statusesshows this company's statuses, including custom ones.
prom_ua_set_order_status changes real orders and the buyer sees it, so the assistant shows the order ids and the new status and waits for your yes; cancelling needs a cancellation_reason. Dates are UTC (2026-10-01T12:00:00). Lists are newest first and page with limit plus last_id: for the next page, pass the lowest id you received as last_id.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
Prom.uatools.
Available tools
| Tool | What it does |
|---|---|
prom_ua_list_orders | List Prom.ua orders of the company, newest first, with buyer, contact, delivery and payment details and the ordered products |
prom_ua_get_order | Get one Prom.ua order by its numeric id: buyer and contact data, delivery method and address, payment, status and the products with… |
prom_ua_list_order_statuses | List the order statuses available to this Prom.ua company, including custom statuses and their ids |
prom_ua_set_order_status | Change the status of one or more Prom.ua orders (received, delivered, canceled, paid) or set a custom status |
prom_ua_list_products | List products of the Prom.ua store with name, SKU, price, availability, group and images |
prom_ua_get_product | Get one Prom.ua product by its numeric Prom id, with description, prices, stock state, group and images |
prom_ua_get_product_by_external_id | Get one Prom.ua product by the id it has in the seller's own accounting or ERP system (external_id) |
prom_ua_list_groups | List the product groups (store categories) of the Prom.ua company with ids, names and parent groups |
prom_ua_list_clients | List the store's Prom.ua clients (buyers) with contact data, or search them by name, phone number or e-mail |
prom_ua_get_client | Get one Prom.ua client by numeric id, with contact details and order statistics |
prom_ua_list_messages | List messages that buyers sent to the store through Prom.ua (questions about products and orders), filtered by read status or date |
FAQ
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?
