# Mind Upload MCP server

> Lets an AI client consult a user's digital consciousness for direction and review agent work against stored memories and rules.

- Repository: https://github.com/Voidborn-Industries/mindupload-sdk-python
- Page: https://hostedmcp.org/servers/voidborn-industries/mindupload-sdk-python
- Transport: stdio, remote
- Stars: 2
- License: MIT
- Latest version: 1.15.47

## Install

### Claude Code

```sh
claude mcp add --env MINDUPLOAD_PARTNER_KEY=<YOUR_MINDUPLOAD_PARTNER_KEY> mindupload-sdk-python -- npx -y mindupload
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mindupload-sdk-python": {
      "command": "npx",
      "args": [
        "-y",
        "mindupload"
      ],
      "env": {
        "MINDUPLOAD_PARTNER_KEY": "<YOUR_MINDUPLOAD_PARTNER_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mindupload-sdk-python": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mindupload"
      ],
      "env": {
        "MINDUPLOAD_PARTNER_KEY": "<YOUR_MINDUPLOAD_PARTNER_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mindupload-sdk-python": {
      "command": "npx",
      "args": [
        "-y",
        "mindupload"
      ],
      "env": {
        "MINDUPLOAD_PARTNER_KEY": "<YOUR_MINDUPLOAD_PARTNER_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mindupload-sdk-python]
command = "npx"
args = ["-y", "mindupload"]

[mcp_servers.mindupload-sdk-python.env]
MINDUPLOAD_PARTNER_KEY = "<YOUR_MINDUPLOAD_PARTNER_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mindupload-sdk-python": {
      "command": "npx",
      "args": [
        "-y",
        "mindupload"
      ],
      "env": {
        "MINDUPLOAD_PARTNER_KEY": "<YOUR_MINDUPLOAD_PARTNER_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MINDUPLOAD_PARTNER_KEY` | no | yes | Private partner key required for consciousness direction and work review; installation can start without it. |
| `MINDUPLOAD_PARTNER_KEY` | no | yes | Private partner key required for consciousness direction and work review; installation can start without it. |
| `MINDUPLOAD_CLONE_ID` | no | no | Optional owner-approved consciousness identifier for personal guidance. |
| `MINDUPLOAD_CLONE_ID` | no | no | Optional owner-approved consciousness identifier for personal guidance. |
| `MINDUPLOAD_EXTERNAL_SUBJECT` | no | no | Stable user identifier required to link an owner-approved consciousness. A label, not a password. |
| `MINDUPLOAD_EXTERNAL_SUBJECT` | no | no | Stable user identifier required to link an owner-approved consciousness. A label, not a password. |
| `MINDUPLOAD_INSTALLATION_ID` | no | no | Stable installation identifier required for consciousness direction and work review. A label, not a password. |
| `MINDUPLOAD_INSTALLATION_ID` | no | no | Stable installation identifier required for consciousness direction and work review. A label, not a password. |

## FAQ

### What does the Mind Upload MCP server do?

It acts as a meta harness that allows your AI consciousness to provide direction via 'consult_mind' and verify results via 'review_work' against your stored rules and memories.

### How do I install the Mind Upload MCP server?

You can install it using npx with the command: npx --yes --package mindupload@1.15.44 mindupload-mcp

### Is a partner key required to use the MCP server?

No, adding the MCP endpoint to your agent and signing in does not require a partner key, and installation alone does not link a mind or perform a review.

### How accurate is the consciousness review compared to an agent alone?

In testing, a coding agent alone caught 85% of rule breaches, while adding the owner's consciousness review increased detection to 100%.