Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"retailcrm": {
"env": {
"RETAILCRM_DOMAIN": "yourstore.retailcrm.ru",
"RETAILCRM_API_KEY": "your-api-key"
},
"args": [
"-y",
"@theyahia/retailcrm-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Production-grade MCP server for RetailCRM e-commerce CRM. 15 tools + 2 prompt skills for managing orders, customers, products, references, and analytics via API v5.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@theyahia/retailcrm-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @theyahia/retailcrm-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in ecommerce
A command line tool for setting up commercetools MCP server
Rent GPUs, robots, drones, and construction gear on RIGShare; also onboards equipment owners.
Electronic component sourcing, BOM management, and PCB design workflows.
Read-only merchant data from 8 Chinese e-commerce platforms: orders, products, after-sales, ads
MCP Security Weekly
Get CVE alerts and security updates for io.github.theYahia/retailcrm-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Production-grade MCP server for RetailCRM e-commerce CRM. 39 tools + 2 prompt skills for managing orders, customers, products, inventory, payments, tasks, references, and analytics via API v5.
Read tools return a compact, shaped summary of only the fields an agent needs — not the full RetailCRM payload. Control verbosity per call:
| Param | Effect |
|---|---|
| (default) | detail:"summary" — essential fields + a pagination block |
detail:"full" | All shaped fields (line items, delivery, payments, address…) |
raw:true | The untouched RetailCRM response (for debugging) |
⚠️ v3 is a breaking change vs v2: default output is now the shaped summary instead of raw JSON. Pass
raw:trueto restore the old payload.
| Tool | Description |
|---|---|
list_orders | List orders by status, customer, number, date range |
get_order | Get one order by ID or externalId |
create_order | Create an order; link an existing customer (customer_id/customer_external_id) or create one inline |
update_order | Update status, customer, delivery, comments |
orders_history | Order change history incl. status transitions (incremental sync) |
| Tool | Description |
|---|---|
list_customers | Search customers by name, email, phone, date |
get_customer | Get one customer by ID or externalId |
create_customer | Create a customer |
update_customer | Edit an existing customer |
merge_customers | Merge duplicates (destructive) |
customers_history | Customer change log (growth/churn, incremental sync) |
| Tool | Description |
|---|---|
list_products | Catalog products by name, group, active, price |
list_product_groups | Product category tree |
store_inventories | Stock levels & cost prices per offer/warehouse |
| Tool | Description |
|---|---|
order_payment_create | Record a payment on an order |
order_payment_edit | Edit a payment |
order_payment_delete | Delete a payment (destructive) |
| Tool | Description |
|---|---|
customer_notes_list / customer_notes_create / customer_notes_delete | Free-text customer notes |
tasks_list / tasks_create / tasks_edit | Follow-up tasks/reminders |
| Tool | Description |
|---|---|
list_segments | Customer segments (RFM/marketing cohorts) |
list_costs / create_cost | Expense records for margin analytics |
| Tool | Description |
|---|---|
files_list / files_get / files_upload | Attach & retrieve files (raw octet-stream upload) |
| Tool | Description |
|---|---|
list_statuses / list_delivery_types / list_payment_types / list_stores | Order/delivery/payment/store reference data |
list_sites | Sites the API key can act on (fill the site param) |
list_countries / list_order_types / list_order_methods | Address & order reference data |
| Tool | Description |
|---|---|
get_orders_summary | Period-scoped order stats: exact count + revenue, AOV, status distribution |
get_customers_summary | New-customer count for a date range |
| Skill | Description |
|---|---|
new-orders | Quick daily overview of today's orders |
customer-search | Find a customer by name, email, or phone |