SkillFoxx

Mindbox CDP MCP server

mindbox-mcp

An MCP server for the Mindbox CDP platform: customer profiles, subscriptions, orders, segments and arbitrary API operations

  • 4 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Gives access to customer profiles and orders
  • run_operation can execute any operation configured in the project, including data changes
All reasons and checks
Russian stack

theyahia/mindbox-mcpAuthor:theYahia

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mindbox-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Gives access to customer profiles and orders
  • run_operation can execute any operation configured in the project, including data changes

This is third-party code. Review the repository files before installing.

What it does

The server gives an agent six Mindbox tools: customer profile and subscriptions, orders, segment membership checks, product lists, and a generic run_operation call for anything not covered by the typed tools. Requests go to api.mindbox.ru with idempotency via transactionId and backoff retries. An important detail: Mindbox operation system names are configured per customer project rather than being universal built-in methods, so names like Website.GetCustomerInfo are just a common convention that a project admin has to create.

Who it is for. For marketers and developers using Mindbox as their CDP who want to pull customer profiles and segments through an agent instead of exporting to Excel.

Good fit when

  • You need to quickly check a customer's purchase history by email without opening the Mindbox interface
  • You need to check whether a customer falls into a specific segment
  • You need an arbitrary call to a Mindbox operation configured in your project

Not a fit when

  • Operation system names are not configured in your Mindbox project: the server will return a ProtocolError on the example default names
  • You need bulk customer profile changes without review: run_operation executes exactly what is configured in the project, including irreversible operations

Example request

Show the order history for the customer with this email and check whether they are in the repeat-buyer segment

MCP

Transport
stdio, http
Authentication
API key

Environment variables

MINDBOX_API_KEY required, secret
Mindbox secret key from the project settings.
MINDBOX_ENDPOINT_ID required
Mindbox project endpoint ID.

Limitations

Operation names (`operation`) are not universal: a Mindbox project admin configures them, and README defaults like Website.GetCustomerInfo only work if that operation exists in your project. HTTP mode listens on 127.0.0.1 by default; running behind a proxy needs manually opening the host and setting MINDBOX_HTTP_ALLOWED_HOSTS against DNS rebinding. This is an unofficial community project.

How to disable. Remove the server from your MCP client config, for example claude mcp remove mindbox in Claude Code.

FAQ

Does run_operation call any Mindbox operation?

Only ones configured in your project under a specific system name; Mindbox has no universal method list.

Can it call async operations?

Yes, run_operation with mode: "async" sends fire-and-forget events like a page view or add-to-cart.

Discussion

No questions or reviews yet.

MCP servers

RetailCRM MCP

retailcrm-mcp

Russian stack

RetailCRM MCP server: orders, customers, products, stock, payments, tasks and store analytics via API v5

MCP serverBroad access2
Official

Open-source CRM for small teams with MCP: contacts, deals and tasks open to Claude and other agents, with reply drafts left to you

MCP serverBroad access221
Russian stack

A minimal MCP server for amoCRM API v4: read and create leads, contacts and notes, with OAuth2 and long-term tokens

MCP serverBroad access12
Russian stack

An MCP server for the InSales online store platform: products, orders, customers and categories via the admin API

MCP serverBroad access1

YCLIENTS MCP server

YCLIENTS MCP Server

Russian stack

An MCP server for YCLIENTS with 30-plus tools covering companies, services, staff, clients, bookings, online booking and analytics

MCP serverBroad access

README in short

The Russian README explains Mindbox's secretKey header auth model and the difference between the API's sync and async endpoints, gives connection instructions for Claude Desktop, Claude Code, Docker and Smithery, an environment variable table, and a warning about per-project operation system names.

README badge

Report a problem