UXPressia MCP Server

Minimal stdio MCP server for UXPressia.

Requirements

• Node.js 18 or newer
• A UXPressia base URL
• A UXPressia API key (contact [email protected] to get one)

Installation

Run directly from npm:

npx -y @uxpressia/mcp-server

Or install globally:

npm install -g @uxpressia/mcp-server

When installed globally, start it with:

uxpressia-mcp-server

Configuration

Set these environment variables before starting the server:

• UXPRESSIA_BASE_URL - UXPressia backend base URL, for example https://your-uxpressia-instance.example.com
• UXPRESSIA_API_KEY - API key created (contact [email protected] to get one)
• UXPRESSIA_TIMEOUT_MS - optional request timeout in milliseconds, defaults to 30000

Available tools

• list_workspaces - returns workspaces available for the API key user
• list_workspace_documents - lists workspace documents; type may be cjm, persona, or impact-map, and if omitted the tool returns all document types available to the API
• get_document - returns a single workspace document by id
• create_or_get_cjm_chat - creates an AI assistant session for a customer journey map or returns the latest existing session for the user
• get_cjm_chat - returns an AI assistant session for a customer journey map and, by default, its conversation history
• send_cjm_chat_message - sends a prompt to the AI assistant for a customer journey map so it can analyze the map, generate insights, suggest improvements, or update the map with new findings

Claude Desktop

{
  "mcpServers": {
    "uxpressia": {
      "command": "npx",
      "args": ["-y", "@uxpressia/mcp-server"],
      "env": {
        "UXPRESSIA_BASE_URL": "https://your-uxpressia-instance.example.com",
        "UXPRESSIA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Add the server with the Claude Code CLI:

claude mcp add --scope user uxpressia \
  -e UXPRESSIA_BASE_URL=https://your-uxpressia-instance.example.com \
  -e UXPRESSIA_API_KEY=your-api-key \
  -e UXPRESSIA_TIMEOUT_MS=30000 \
  -- npx -y @uxpressia/mcp-server

If you want the server only for the current repository, use --scope project instead of --scope user.

Keep the server name (uxpressia) before the -e flags. Claude Code currently parses -e greedily, so claude mcp add ... -e KEY=value uxpressia -- ... fails with Invalid environment variable format.

Verify that Claude Code can see the server:

claude mcp list

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.uxpressia]
command = "npx"
args = ["-y", "@uxpressia/mcp-server"]
env = { UXPRESSIA_BASE_URL = "https://your-uxpressia-instance.example.com", UXPRESSIA_API_KEY = "your-api-key", UXPRESSIA_TIMEOUT_MS = "30000" }

Cursor

Add this to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "uxpressia": {
      "command": "npx",
      "args": ["-y", "@uxpressia/mcp-server"],
      "env": {
        "UXPRESSIA_BASE_URL": "https://your-uxpressia-instance.example.com",
        "UXPRESSIA_API_KEY": "your-api-key",
        "UXPRESSIA_TIMEOUT_MS": "30000"
      }
    }
  }
}

License

MIT. See LICENSE.