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
-
Get your API token — open the SoulPrint Chrome extension, connect your account, and copy your token. Or visit https://soulprintengine.ai/settings/tokens
-
Add to your agent:
Claude Code — run in your terminal:
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
| Tool | What it does |
|---|---|
soulprint_get_profile |
Your identity — communication style, descriptors, values, interests |
soulprint_get_memories |
Search your memories by keyword, ranked by relevance |
soulprint_get_context |
Combined profile + relevant memories + active Imprint, ready for prompt injection |
soulprint_list_imprints |
List your installed + marketplace Imprints and the active one |
soulprint_set_imprint |
Select / activate an Imprint (global default or per-project) |
soulprint_add_memory |
Save a new memory |
soulprint_update_memory |
Edit a memory's content, category, or importance |
soulprint_delete_memory |
Delete a memory |
Requirements
- Python 3.12+
- A SoulPrint Engine account (free tier works — 10 memories, 2 surfaces)
- API token from the extension or soulprintengine.ai
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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file soulprint_mcp-0.3.0.tar.gz.
File metadata
- Download URL: soulprint_mcp-0.3.0.tar.gz
- Upload date:
- Size: 60.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6ebbfe405106c6b8835feaf2d7b18fb7350fe1cd9653d6d8478a1f00e77b3d0c
|
|
| MD5 |
594c9fb3967da85b561a2ae6e08c2a5e
|
|
| BLAKE2b-256 |
c20b13931d83ae7daea258bed41fe590630d5a0feafaaaf37634ac887e1dd68d
|
File details
Details for the file soulprint_mcp-0.3.0-py3-none-any.whl.
File metadata
- Download URL: soulprint_mcp-0.3.0-py3-none-any.whl
- Upload date:
- Size: 10.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
71b62193958e28a57d25d1503ce8b88659360ea97520339fc3338a4d84621603
|
|
| MD5 |
7d02dc0c2165c505719f012d7422b088
|
|
| BLAKE2b-256 |
9681e989fcff67c605d232df9435656bfde75e391981501c4b47f44f85ac0cd9
|