SoulPrint MCP Server

Your identity, in every AI agent. Connect your SoulPrint Engine account to any MCP-compatible agent (Claude Code, Cursor, Hermes, Codex) and they'll know how to communicate with you, what matters to you, and what you've told them before.

Install

pip install soulprint-mcp
# or
uvx soulprint-mcp

Setup

Full walkthrough for every agent (Claude Code, Cursor, Codex, Hermes) with prerequisites, caveats, and troubleshooting: docs/connect-your-ai.md.

Quick start — sign in (recommended)

Run the one-time login flow; it prints a short code, you approve it in the browser, and the token is cached at ~/.soulprint/token.json:

soulprint-mcp login

Then add the server to your agent without a token — it reads the cached one:

Claude Code:

claude mcp add soulprint -- uvx soulprint-mcp

Codex — add to ~/.codex/config.toml:

[mcp_servers.soulprint]
command = "uvx"
args = ["soulprint-mcp"]

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "soulprint": {
      "command": "uvx",
      "args": ["soulprint-mcp"]
    }
  }
}

Hermes:

hermes mcp add soulprint --command "soulprint-mcp"

Explicit token

Or pass your own API token with --token YOUR_TOKEN. Get a token from the SoulPrint Chrome extension (connect your account) or https://soulprintengine.ai/settings/tokens.

Claude Code:

claude mcp add soulprint -- uvx soulprint-mcp --token YOUR_TOKEN

Codex — add to ~/.codex/config.toml:

[mcp_servers.soulprint]
command = "uvx"
args = ["soulprint-mcp", "--token", "YOUR_TOKEN"]

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "soulprint": {
      "command": "uvx",
      "args": ["soulprint-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}

Hermes:

hermes mcp add soulprint --command "soulprint-mcp --token YOUR_TOKEN"

Tools

Requirements

• Python 3.12+
• A SoulPrint Engine account (free tier works — 10 memories, 2 surfaces)

Privacy

Your token and memories never leave your machine except when calling the SoulPrint Engine API over HTTPS. The MCP server runs locally — no third-party servers involved.