Get started with MCP

This guide walks you through connecting an MCP-compatible AI application or platform to the Loomi Connect MCP servers. Once connected, your AI application can read live data from your Bloomreach workspace through more than 80 read-only tools.

📘
Note
Loomi Connect is currently in Beta. Contact [email protected] to get access to the Beta MCP service.

Prerequisites

A Bloomreach account with access to the workspace you want to query. The MCP server respects your existing Bloomreach IAM permissions, including PII masking.
One of the following AI applications (or another platform with support to connect MCPs):

Setup overview

Loomi Connect runs remote MCP servers, so there's nothing to install locally. Connect to an AI application in three steps:

Add a Loomi Connect server URL to your AI application's MCP configuration.
Restart or reload the AI application so it picks up the new server.
Trigger a tool call to start the browser-based authentication flow.

Connect the MCP server

⚠️
Important
Replace <MCP_SERVER_URL> in every example with the Loomi Connect MCP server endpoint. Contact [email protected] to learn more and get access to the URL endpoint. The URL ends in /mcp and uses Streamable HTTP transport.

Follow the steps for your preferred environment to connect the MCP server:

Run this command in your terminal:

claude mcp add loomi-mcp --transport http <MCP_SERVER_URL>

To verify the server was added, run:

claude mcp list

Refer to the Claude Code documentation for more details on MCP configuration.

Verify the connection

After restarting your AI application, confirm that Loomi Connect is registered and available in the project:

In Claude Code, type /mcp in a new session.
In Cursor, open the MCP settings panel (File > Preferences > Cursor Settings > MCP).
In VS Code, open the Extensions tab to see installed MCP servers. You can also type @mcp in the command palette.

The first time your AI application calls a Loomi Connect tool, a browser window opens to the Bloomreach login page so you can authenticate. Sessions persist for up to 30 days.

Next steps

Authenticate MCP connection: sign in with your Bloomreach account and confirm your AI application can read live workspace data.