How to Use the Bloomreach MCP in Cursor

Q: How do I configure the Bloomreach MCP server in my Cursor project?

Create a .cursor/mcp.json file in your repository root. Add the server under the mcpServers key with your Vinkius credentials, and the Cursor agent will immediately detect the tools.

Q: Why does Cursor need access to listattributes in my Bloomreach setup?

Accessing listattributes allows your agent to see the exact keys used in your database. This lets the editor write clean database queries and validation schemas for your customer profiles.

Feed live Bloomreach catalog schema and customer segments directly to Cursor to write accurate, type-safe personalization code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bloomreach MCP to Cursor

Create your Vinkius account to connect Bloomreach to Cursor and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Bloomreach with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Code Using Real Catalog Schemas

Stop writing code against outdated API documentation or mock payloads. When you ask Cursor to build a product recommendation widget, the editor runs `list_catalogs` and `list_properties` to fetch the exact fields currently live in your store. This MCP server lets Cursor write highly accurate TypeScript interfaces and component code. The editor then uses `get_catalog_items` to pull actual inventory records that match your real production data structure perfectly.

Debug Active Marketing Webhooks in the Editor

When webhook payloads change, your backend code can break silently. Let Cursor run `list_webhooks` using this MCP server to inspect your active endpoints and see where Bloomreach is sending event data. You can also call `list_event_types` to see what user interactions are being tracked. Having this live context inside your workspace means you can write precise event handlers without guessing the payload keys.

Target Active Customer Segments with this MCP Server

Writing custom frontend logic for specific user groups is tricky when you don't know the exact segment names. This server lets you run `list_segments` and `list_segmentations` directly from the Cursor chat sidebar. Once you have the exact segment identifiers, you can ask the agent to write conditional middleware. It can use `list_attributes` to ensure your code checks the correct user metadata before rendering targeted promotions.

Setup guide

Set up Bloomreach MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Bloomreach MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Bloomreach transactions." If the MCP tools are loaded correctly, Cursor will call the Bloomreach tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "bloomreach-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Bloomreach. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Bloomreach now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Bloomreach MCP in Cursor

Create a `.cursor/mcp.json` file in your repository root. Add the server under the mcpServers key with your Vinkius credentials, and the Cursor agent will immediately detect the tools.

No, the tools exposed by this server are strictly for reading configuration and customer data. Your agent can call `list_campaigns` to inspect your marketing setup, but it cannot alter any active runs.

Accessing `list_attributes` allows your agent to see the exact keys used in your database. This lets the editor write clean database queries and validation schemas for your customer profiles.

Yes, it does. When you enable Agent Mode, Cursor can automatically run tools like `get_customer_properties` to diagnose coding issues or verify data structures while it writes your code.

Your customer attributes and event types are processed entirely within Cursor's secure local editor environment. Vinkius manages the connection using ephemeral sandboxes, meaning your sensitive customer properties are never saved or cached.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript