How to add Intlayer MCP Server to Windsurf

AI-powered IDE assistance for the Intlayer i18n ecosystem: docs, CLI, and dictionary management. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 767★ · stdio · no auth

Windsurf config for Intlayer MCP Server

npx -y @intlayer/mcp

{
  "mcpServers": {
    "intlayer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@intlayer/mcp"
      ]
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Intlayer MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Intlayer MCP Server's tools become available to Cascade.

Before you start

Node.js with npx available
An MCP-capable client (Cursor, VS Code, Claude Desktop, Claude Code, ChatGPT, etc.)
An Intlayer project (for CLI and dictionary/CMS tools)

What Intlayer MCP Server can do in Windsurf

get-doc-list

Get the list of available Intlayer documentation entries.

get-doc

Get an Intlayer documentation entry by its key.

get-doc-by-slug

Get an Intlayer documentation entry by its slug.

fetch-doc-chunks

Fetch chunks of Intlayer documentation for context.

review-doc-blocks

Review documentation blocks.

intlayer-init

Initialize Intlayer in the project.

intlayer-build

Build the Intlayer dictionaries.

intlayer-fill

Fill missing translations in dictionaries.

Security

The local stdio server runs Intlayer CLI commands on your machine (build, fill, push, pull, extract) and can manage CMS dictionaries/organizations, so review actions before allowing them. The remote Streamable HTTP server at https://mcp.intlayer.org is public, unauthenticated, exposes only documentation tools, and its availability is not guaranteed.

Intlayer MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Intlayer MCP Server config there under the "mcpServers" key and restart the client.

Is Intlayer MCP Server safe to use with Windsurf?

Which clients are supported?

Any MCP-capable environment, including Cursor, VS Code, Claude Desktop, Claude Code, and AI assistants like Gemini and ChatGPT.

What is the difference between the local and remote servers?

The local stdio server (@intlayer/mcp) integrates all features including CLI and API tools and is recommended. The remote Streamable HTTP server at https://mcp.intlayer.org is public, unauthenticated, and free, but only exposes documentation tools and has no availability guarantee.

How do I set it up quickly?

Run `npx intlayer init mcp`, which asks for your platform and transport and updates the right config file (e.g. .cursor/mcp.json, .vscode/mcp.json, or the Claude Desktop config). You can also use the Intlayer VS Code extension or add the config block manually.

View repo Full Intlayer MCP Server page