Advertise
MCP.so
Sign In

Inoyu Apache Unomi MCP Server

@sergehuber

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

sergehuber

About Inoyu Apache Unomi MCP Server

An implementation of Anthropic's Model Context Protocol for the Apache Unomi CDP

#inoyu#unomi#customer-data-platform

Inoyu Apache Unomi MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": [
        "@inoyu/mcp-unomi-server"
      ],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_VERSION": "3",
        "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",
        "UNOMI_TENANT_ID": "your-tenant-id",
        "UNOMI_PUBLIC_KEY": "your-public-key",
        "UNOMI_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

Inoyu Apache Unomi MCP Server tools

6

Get your profile using environment variables

Update properties of your profile

Retrieve a specific profile by ID

Search for profiles

Create a new Unomi scope

Get information about the current tenant (V3 only)

Overview

What is Inoyu Apache Unomi MCP Server?

A Model Context Protocol server that enables Claude to maintain user context through Apache Unomi profile management. It integrates with Apache Unomi (versions 2 and 3) for user recognition, context storage, and consent management. This is an early implementation intended for demonstration and learning, not for production use.

How to use Inoyu Apache Unomi MCP Server?

Install via npx @inoyu/mcp-unomi-server and configure environment variables (UNOMI_BASE_URL, UNOMI_VERSION, authentication keys) in the Claude Desktop configuration file. Restart Claude Desktop after configuration.

Key features of Inoyu Apache Unomi MCP Server

  • Email-based profile lookup with automatic creation
  • Profile properties, segments, and scores access
  • Automatic session management with date-based IDs
  • Consent management with GDPR-compliant expiration
  • Scope management with automatic scope creation
  • Supports both Apache Unomi V2 and V3

Use cases of Inoyu Apache Unomi MCP Server

  • Maintain user preferences across conversations with Claude
  • Store and retrieve user-specific information persistently
  • Manage user consent preferences and comply with privacy regulations
  • Identify users across sessions using email or profile ID

Frequently asked questions

1

What are the runtime dependencies?

A running Apache Unomi server, Claude Desktop, network access to the Unomi server, and proper environment variables.

2

Where does user profile data live?

All profile data is stored in the Apache Unomi server; the MCP server acts as a bridge and does not persist data itself.

3

What are the known limitations of this implementation?

This early implementation only supports profile lookup/creation, property management, basic session handling, and scope management. Events, segments, session properties, and other Unomi features are not yet implemented.

4

How does authentication work for Unomi V2 versus V3?

V2 uses system administrator credentials (username, password, and key). V3 uses tenant-based authentication with a tenant ID, public key, and private key for different endpoint types.

Comments

More Other MCP servers

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise