UILM MCP Server

UILM MCP Server

MCP (Model Context Protocol) server for the SELISE Blocks UILM (UI Language Management) API. Provides translation key management tools for Claude Code, Cursor, and any MCP-compatible client.

Features

• Automatic Bearer token management (caches + auto-refreshes on 15-min expiry)
• Module name resolution (use "auth" instead of UUIDs)
• Batch key creation with automatic fallback
• 13 tools covering modules, languages, and translation keys

Quick Start

Option A: Interactive setup (recommended)

npx uilm-mcp-server --init

This walks you through entering credentials and writes the config directly to your Claude Code or Cursor settings.

Option B: Manual config

Add to your project's .mcp.json (Claude Code) or Cursor MCP settings:

{
  "mcpServers": {
    "uilm": {
      "command": "npx",
      "args": ["-y", "uilm-mcp-server"],
      "env": {
        "UILM_API_BASE_URL": "https://api.seliseblocks.com",
        "UILM_PROJECT_KEY": "your-project-key",
        "UILM_CLIENT_ID": "your-client-id",
        "UILM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

No clone or build step required -- npx handles everything.

Option C: Using a .env file

Create a .env file in your project root (make sure it's in .gitignore):

UILM_API_BASE_URL=https://api.seliseblocks.com
UILM_PROJECT_KEY=your-project-key
UILM_CLIENT_ID=your-client-id
UILM_CLIENT_SECRET=your-client-secret

Then use a simpler MCP config without the env block:

{
  "mcpServers": {
    "uilm": {
      "command": "npx",
      "args": ["-y", "uilm-mcp-server"]
    }
  }
}

Getting Your Credentials

You need four values from the SELISE Blocks platform.

API Base URL

https://api.seliseblocks.com

Project Key

1. Log in to the SELISE Blocks Console
2. Select your project
3. Go to Settings (gear icon)
4. Copy the Project Key (starts with P)

Client ID and Client Secret

These are OAuth credentials used for machine-to-machine authentication:

1. In the SELISE Blocks Console, navigate to your project
2. Go to IAM > Clients (or Settings > API Clients, depending on your console version)
3. Click Create Client (or use an existing one)
4. Set the grant type to Client Credentials
5. Copy the Client ID (UUID format) and Client Secret

Note: If you don't see the Clients section, ask your project admin to create a client credential for you or grant you access to IAM settings.

Environment Variables

| Variable | Description | |----------|-------------| | UILM_API_BASE_URL | SELISE Blocks API base URL | | UILM_PROJECT_KEY | Project key (starts with P, used as x-blocks-key header) | | UILM_CLIENT_ID | OAuth client ID (UUID format) | | UILM_CLIENT_SECRET | OAuth client secret |

Tools

Auth

| Tool | Description | |------|-------------| | uilm_authenticate | Force-refresh Bearer token and check auth status |

Modules

| Tool | Description | |------|-------------| | uilm_list_modules | List all modules with IDs | | uilm_create_module | Create a new translation module |

Languages

| Tool | Description | |------|-------------| | uilm_list_languages | List all configured languages |

Keys (Read)

| Tool | Description | |------|-------------| | uilm_get_keys | Get published translations for a module + language | | uilm_search_keys | Search keys with filters and pagination | | uilm_get_key | Get a single key by item ID | | uilm_get_keys_by_names | Look up keys by name (check existence) |

Keys (Write)

| Tool | Description | |------|-------------| | uilm_create_key | Create a single translation key | | uilm_create_keys | Batch create multiple keys | | uilm_update_key | Update an existing key's translations |

Keys (Delete / Rollback)

| Tool | Description | |------|-------------| | uilm_delete_key | Delete a key by item ID (irreversible) | | uilm_rollback_key | Rollback a key to previous state |

Usage Examples

Once configured, ask your AI assistant:

• "List all UILM modules"
• "Create a translation key LOGIN_TITLE in the auth module with en-US: 'Login' and de-DE: 'Anmelden'"
• "Create these keys in the dashboard module: WELCOME_MESSAGE (Welcome / Willkommen), LOGOUT (Logout / Abmelden)"
• "Search for keys containing 'LOGIN'"
• "Get all English translations for the common module"
• "Delete the key with ID abc-123"

CLI

npx uilm-mcp-server              # Start the MCP server (stdio transport)
npx uilm-mcp-server --init       # Interactive setup wizard
npx uilm-mcp-server --help       # Show help
npx uilm-mcp-server --version    # Show version

Development

git clone https://github.com/sohanuzzaman/uilm-mcp-server.git
cd uilm-mcp-server
npm install        # Also runs build via prepare script
npm run dev        # Run with tsx (hot TypeScript execution)
npm run build      # Compile TypeScript
npm start          # Run compiled version

Verify with MCP Inspector

UILM_API_BASE_URL=https://api.seliseblocks.com \
UILM_PROJECT_KEY=your-project-key \
UILM_CLIENT_ID=your-client-id \
UILM_CLIENT_SECRET=your-client-secret \
  npx @modelcontextprotocol/inspector node dist/index.js