@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