@multilipi/mcp

This is the official Model Context Protocol (MCP) server for the MultiLipi SaaS ecosystem. It allows administrative agents to onboard projects, manage settings, customize linguistic assets, set exclusion rules, and monitor analytics.

🚀 Features

The server exposes the following groups of tools:

1. User Profile & Authentication

• account_signup: Register a new user account. Does not log in automatically.
• account_login: Login and retrieve an access token. Blocks unverified emails.
• get_current_user_profile: Retrieve details of the current logged-in user.

2. Workspaces & Switch

• get_workspace_details: Monitor active workspace name, limits, plan, and consumed credits.
• switch_workspace: Switch to a different workspace.

3. Onboarding & Site Setup

• get_onboarding_options: Retrieve valid industries, target languages, and setup parameters.
• onboard_new_project: Register a website and request a plan.
• verify_dns_infrastructure: Trigger DNS verification for subdomain routing.
• verify_script_integration: Trigger verification for JS widget integration.

4. Projects & Domain Settings

• get_projects_list: Fetch all projects in the active workspace.
• get_project_data: Fetch full configuration, technology, and status for a project.
• update_project_feature_flags: Toggle administrative settings, slug/query translation, limits, and LLM optimization.

5. Analytics & LLM Insights

• get_project_translation_requests: Trend of visitor translation actions.
• get_project_word_consumption: Monitor visitor vs AI word count consumption.
• get_project_page_views: Visual views by locale, country, URL path, browser, and device.
• get_project_llm_analytics: Monitor AI crawler hits, indexing latency, and bot models (e.g. OpenAI SearchBot).

6. Linguistic Assets (Glossary & TM)

• get_linguistic_assets: List all glossary and Translation Memory (TM) terms.
• add_glossary_term / update_glossary_term / delete_glossary_term: Lock specific words or brand names to custom translations.
• add_tm_term / update_tm_term / delete_tm_term: Save/edit sentence translation memory segment overrides.
• sync_glossary_and_translation_memory: Batch upload assets.

7. Translation Exclusion Rules

• get_translation_exclusions: Get active URL regex exclusion rules and HTML element exclusions.
• add_translation_exclusion_rule / delete_translation_exclusion_rule: Exclude entire route patterns (Equals, Contains, Starts With, Ends With, Regex).
• add_translation_exclusion_block / delete_translation_exclusion_block: Exclude DOM sections by class/ID selectors (e.g., .no-translate).

📖 Self-Documentation Resources

The server exposes segregated resources to help agents understand its operation dynamically:

• docs://onboarding/auth-verification: Instructions on user registration, email verification, and login rules.
• docs://onboarding/context-interview: Workspace pre-checks and conversational onboarding questions.
• docs://onboarding/integration-setup: Step-by-step CNAME/TXT DNS and JS script integration layouts.
• docs://onboarding/analytics-monitoring: Guide on tracking page views, translation volume, and LLM indexing.
• docs://onboarding/assets-exclusions: Guide on glossary, Translation Memory, and regex/HTML exclusion rules.

🔑 Authenticating the Agent

To use the MultiLipi MCP server, the agent needs to be authenticated. There are two ways to do this:

1. Dashboard Access Token (Recommended & Required for OAuth/AppSumo Signups):

   • If you signed up using Google, AppSumo, or other OAuth providers, you do not have a dashboard password. In this case, you must fetch your session token from the dashboard.
   • Go to dashboard.multilipi.com/connect-mcp (or your local equivalent).
   • Click Generate Auth Token in the Connection Credentials card.
   • Copy the token and paste it directly to the agent in chat, or manually register it using the set_auth_token tool.

2. Email & Password Login (Traditional Signup):

   • If you registered using a standard email and password, the agent can authenticate you directly using the account_login tool.
   • Note: This will not work if email verification is pending or if your account was created via OAuth.

🔌 Integrating with MCP Hosts & AI Platforms

The recommended way to run this server is via npx, which automatically fetches and runs the latest version. You can configure this server in any MCP-compatible environment (such as Claude Desktop, Cursor, Windsurf, or other AI agent platforms).

Configuration JSON Example

Add the following server definition to your MCP host settings configuration file:

{
  "mcpServers": {
    "multilipi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@multilipi/mcp"
      ],
      "env": {
        "MULTILIPI_API_URL": "https://mcp.multilipi.com"
      }
    }
  }
}

Restart your AI client or MCP host to load the MultiLipi server.