Khwan MCP Server

by khwanlabsai.khwan/khwan-mcpv0.3.12

Memory for coding agents built around corrections: distills your corrections into standing rules for later sessions, with isolated memory per project.

0Pythonstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained43d ago

Install Khwan MCP server

claude mcp add khwan -e KHWAN_API_KEY='<khwan-api-key>' -- uvx khwan-mcp

{
  "mcpServers": {
    "khwan": {
      "command": "uvx",
      "args": [
        "khwan-mcp"
      ],
      "env": {
        "KHWAN_API_KEY": "<khwan-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "khwan": {
      "command": "uvx",
      "args": [
        "khwan-mcp"
      ],
      "env": {
        "KHWAN_API_KEY": "<khwan-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "khwan": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "khwan-mcp"
      ],
      "env": {
        "KHWAN_API_KEY": "<khwan-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "khwan": {
      "command": "uvx",
      "args": [
        "khwan-mcp"
      ],
      "env": {
        "KHWAN_API_KEY": "<khwan-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
KHWAN_API_KEY	yes	yes	Your Khwan key from https://app.khwan.ai (kwk_live_...). It authenticates you to Khwan; it is not your model provider's key.
KHWAN_CORE	—	—	Select a named core (brain). Paid plans only — the free plan has just `default`, and an unknown slug answers 404. Leave unset to use the default.
KHWAN_USER	—	—	A separate brain inside the core, created on first write — 3 on the free plan, unlimited on paid. Sets the X-Khwan-User header.
KHWAN_BASE_URL	—	—	Override the API base URL, e.g. http://127.0.0.1:8010 for a self-hosted engine.

Remote endpoints

streamable-httphttps://mcp.khwan.ai/mcp/{core}/{user}

Freshness

Maintained — last maintenance signal 43d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-27 · 43d ago · GitHub
Latest release
2026-08-27 · 43d ago · GitHub · v0.3.12
Package published
no data · npm/PyPI
Registry entry updated
2026-08-27 · 43d ago · official registry · v0.3.12

FAQ

›How do I install the Khwan MCP server in Claude Code?

Run: claude mcp add khwan -e KHWAN_API_KEY='<khwan-api-key>' -- uvx khwan-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Khwan require an API key?

Yes. It expects KHWAN_API_KEY, of which 1 is a secret.

›Can I use Khwan as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Khwan in the official MCP registry?

Yes, as ai.khwan/khwan-mcp.