Inoyu MCP Unomi Server Integration

What does “Inoyu” MCP Server do?

The Inoyu MCP Unomi Server is a Model Context Protocol (MCP) server that integrates Anthropic’s MCP with the Apache Unomi Customer Data Platform (CDP). This enables AI assistants, such as Claude, to interact with and manage user profiles within Unomi, facilitating contextual awareness and persistent user data across sessions. The server supports profile lookup and creation using email, profile property management, session handling, and scope management for context isolation. By exposing these capabilities via MCP, the Inoyu server allows AI agents to perform advanced user data operations, such as retrieving or updating user information, thereby enhancing development workflows that require persistent, context-rich user data management.

List of Prompts

No prompt templates are listed in the repository or documentation.

List of Resources

No explicit MCP resources are documented or listed in the available repository files.

List of Tools

• get_my_profile
  Retrieves the user’s profile using environment variables. Supports retrieving segment and score information and generates a session ID based on the current date.

• update_my_profile
  Updates properties of the user’s profile. Accepts a properties object with key-value pairs supporting various data types (string, number, boolean, null).

• get_profile
  Retrieves a specific profile by its ID from Unomi, returning the complete profile data.

• search_profiles
  Searches for profiles based on a query string, with optional limit and offset parameters. Searches across firstName, lastName, and email fields.

Use Cases of this MCP Server

• Personalized AI Conversations
  Enables AI assistants to recall and update user information (such as name, preferences, or subscription status), offering a more personalized user experience across sessions.
• Customer Data Management
  Facilitates easy lookup, update, or retrieval of customer profiles directly from Unomi, streamlining customer support and CRM workflows for developers.
• User Segmentation and Targeting
  Provides access to profiles, segments, and scores, allowing developers to segment users and tailor content or offers via AI-integrated workflows.
• Contextual Session Handling
  Automates session management using date-based IDs, ensuring that user context is preserved and isolated across different interactions or sessions.
• Profile Search and Auditing
  Allows searching across profiles for compliance, auditing, or analytics purposes, making it easier to manage large user databases programmatically.

How to set it up

Windsurf

No specific Windsurf instructions are provided.

Claude

1. Ensure prerequisites are met (Node.js and npx).
2. Locate the configuration file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
3. Add the Inoyu MCP Unomi Server configuration:

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_USERNAME": "your-username",
        "UNOMI_PASSWORD": "your-password",
        "UNOMI_PROFILE_ID": "your-profile-id",
        "UNOMI_KEY": "your-unomi-key",
        "UNOMI_EMAIL": "your-email@example.com",
        "UNOMI_SOURCE_ID": "claude-desktop"
      }
    }
  }
}

4. Save the configuration.
5. Restart Claude Desktop to apply changes and verify the server/tools are detected.

Securing API Keys

Use the env section in the JSON configuration to set sensitive credentials as environment variables.

Cursor

No specific Cursor instructions are provided.

Cline

No specific Cline instructions are provided.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "inoyu-unomi": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “inoyu-unomi” to the actual name you wish to use and replace the URL with your MCP server’s address.

Overview

Our opinion

This MCP server provides solid integration for user profile management with Apache Unomi through a clear set of tools and straightforward setup for Claude Desktop. However, the absence of prompt templates, explicit resource definitions, and platform-specific instructions for Windsurf, Cursor, and Cline limits its completeness. It is best suited for experimentation and learning at this stage.

MCP Score

Rating: 6/10
The Inoyu MCP Unomi Server is promising for Unomi profile management and AI integration, but its early stage, lack of resource/prompt details, and limited multi-platform setup reduce its current utility for broader developer audiences.