How to add Inkeep MCP Server to Windsurf

Search your product docs and content via Inkeep's RAG, exposed as an MCP tool. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 25★ · stdio · apikey

Windsurf config for Inkeep MCP Server

git clone https://github.com/inkeep/mcp-server-python.git

{
  "mcpServers": {
    "inkeep-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<YOUR_INKEEP_MCP_SERVER_ABSOLUTE_PATH>",
        "run",
        "-m",
        "inkeep_mcp_server"
      ],
      "env": {
        "INKEEP_API_BASE_URL": "https://api.inkeep.com/v1",
        "INKEEP_API_KEY": "<YOUR_INKEEP_API_KEY>",
        "INKEEP_API_MODEL": "inkeep-rag",
        "INKEEP_MCP_TOOL_NAME": "search-product-content",
        "INKEEP_MCP_TOOL_DESCRIPTION": "Retrieves product documentation about Inkeep. The query should be framed as a conversational question about Inkeep."
      }
    }
  }
}

Setup steps

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

Before you start

An Inkeep account to manage and provide the RAG (https://inkeep.com)
The uv Python project manager (https://github.com/astral-sh/uv)
An Inkeep API key created from the Inkeep portal (Projects > Integrations > Create Integration > API)

What Inkeep MCP Server can do in Windsurf

search-product-content

Configurable retrieval tool (default name from INKEEP_MCP_TOOL_NAME). Retrieves product documentation/content from Inkeep's RAG. The query should be framed as a conversational question, and the tool name/description are customizable via the INKEEP_MCP_TOOL_NAME and INKEEP_MCP_TOOL_DESCRIPTION environment variables.

Security

Requires an Inkeep API key (created from the Inkeep portal under Integrations > API). The key is passed via the INKEEP_API_KEY environment variable in your MCP client config; keep it secret and avoid committing it.

Inkeep MCP Server + Windsurf FAQ

Where is the Windsurf config file?

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

Is Inkeep MCP Server safe to use with Windsurf?

Do I need an Inkeep account?

Yes. You need an Inkeep account to manage and provide the RAG, and you must create an API key from the Inkeep portal (Projects > Integrations > Create Integration > API).

How is the search tool named?

The tool name and description are configurable through the INKEEP_MCP_TOOL_NAME and INKEEP_MCP_TOOL_DESCRIPTION environment variables. The README's example uses search-product-content.

What runtime does it use?

Python, run via the uv project manager. You clone the repo, create a uv venv, install dependencies from pyproject.toml, and launch it with `uv run -m inkeep_mcp_server`.

View repo Full Inkeep MCP Server page