Inoyu

Inoyu

Interact with an Apache Unomi CDP customer data platform to retrieve and update customer profiles

7
Stars
9
Forks
0
Releases

Overview

This MCP server provides a bridge between Claude Desktop and Apache Unomi, enabling Claude to maintain persistent user context by managing Unomi profiles, scopes, and consent data. It supports profile lookup and automatic creation by email, and provides access to profile properties, segments, and scores via JSON exchanges. It handles automatic session management with date-based IDs and uses a default scope (claude-desktop) for session isolation, while allowing creation of additional scopes via the create_scope tool. The server is designed as an early implementation for demonstration purposes and supports both Unomi V2 and V3 with automatic version detection and appropriate authentication methods. Tools exposed include get_my_profile, update_my_profile, get_profile, search_profiles, create_scope, get_tenant_info (V3), and consent tools (update_consent, get_consent, list_consents). Profile resolution follows a two-step process: if UNOMI_EMAIL is set, it tries an email lookup; otherwise, it falls back to UNOMI_PROFILE_ID, with the response indicating the lookup method. The project emphasizes testing and experimentation and notes that it is not production-ready.

Details

Owner
sergehuber
Language
JavaScript
License
Apache License 2.0
Updated
2025-12-07

Features

Profile Access and Management

Email-based profile lookup with automatic creation; access to profile properties, segments, and scores; JSON data exchange; automatic session management with date-based IDs.

Session and Context Management

Automatic session handling with date-based IDs; uses default claude-desktop scope for session isolation and continuity across conversations.

Scope Management

Default scope 'claude-desktop' used for all operations; automatic scope creation when needed; manual scope creation via the create_scope tool.

Unomi V2/V3 Compatibility and Authentication

Supports Unomi V2 and V3 with automatic version detection and distinct authentication methods; V2 uses system administrator credentials; V3 uses tenant-based API keys.

Profile and Consent Tools

Provides profile tools (get_my_profile, update_my_profile, get_profile, search_profiles) and consent tools (update_consent, get_consent, list_consents) for GDPR-aware data handling.

Two-Step Profile Resolution

Resolves profile ID via email lookup if UNOMI_EMAIL is set; otherwise uses UNOMI_PROFILE_ID; reports method via 'source' (email_lookup or environment).

Audience

DevelopersSetting up Claude Desktop integration to manage user profiles, scopes, and consent via Unomi.

Tags

UnomiMCPprofile-managementconsentscopesession-managementClaude-DesktopV2V3integrationcontext