@kovamind/mcp-server

MCP server for Kova Mind — use AI memory in Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible client.

Quick setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kovamind": {
      "command": "npx",
      "args": ["-y", "@kovamind/mcp-server"],
      "env": {
        "KOVAMIND_API_KEY": "km_live_xxx",
        "KOVAMIND_USER_ID": "my-user"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "kovamind": {
      "command": "npx",
      "args": ["-y", "@kovamind/mcp-server"],
      "env": {
        "KOVAMIND_API_KEY": "km_live_xxx",
        "KOVAMIND_USER_ID": "my-user"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "kovamind": {
      "command": "npx",
      "args": ["-y", "@kovamind/mcp-server"],
      "env": {
        "KOVAMIND_API_KEY": "km_live_xxx",
        "KOVAMIND_USER_ID": "my-user"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "kovamind": {
      "command": "npx",
      "args": ["-y", "@kovamind/mcp-server"],
      "env": {
        "KOVAMIND_API_KEY": "km_live_xxx",
        "KOVAMIND_USER_ID": "my-user"
      }
    }
  }
}

Environment variables

Variable	Required	Default	Description
KOVAMIND_API_KEY	Yes	—	Your Kova Mind API key
KOVAMIND_API_URL	No	https://api.kovamind.io	API base URL
KOVAMIND_USER_ID	No	—	Default user ID for all operations

Available tools

Memory

Tool	Description
memory_extract	Extract memory patterns from a conversation
memory_recall	Retrieve relevant memories for a context
memory_reinforce	Confirm, deny, strengthen, or weaken a pattern
memory_surprise	Score how novel content is vs existing memory
memory_health	Check API health status

Vault (zero-exposure credentials)

Credential values never reach the AI. Store a credential once, get back an opaque handle, then ask the AI to act with that handle — the value flows through a secure side channel.

Tool	Description
vault_setup	One-time vault setup. Returns 12 recovery words — store them safely
vault_unlock	Unlock the vault with your passphrase
vault_lock	Lock the vault and zero the key from memory
vault_store	Store a credential. Returns an opaque handle
vault_handles	List available handles (never the values)
vault_find	Search handles by natural-language query
vault_execute	Run an action (http request, browser fill) using a handle

Get an API key

Sign up at kovamind.io to get your API key.

License

MIT