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 |
Communication style, values, interests, personality descriptors |
soulprint_get_memories |
Search your stored memories by keyword |
soulprint_get_context |
Combined profile + relevant memories, ready for prompt injection |
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.1.0.tar.gz.
File metadata
- Download URL: soulprint_mcp-0.1.0.tar.gz
- Upload date:
- Size: 56.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/7.0.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9fd86828d890b5e534ecec1c90ff24aabbe5d5a647d8ed5a08b658b026b76beb
|
|
| MD5 |
ab19ca943c086bb7508e85ee7fbff2e8
|
|
| BLAKE2b-256 |
a082ebf57f520cbdf7e572196423c20889018e2cf9c2852b4fea9c68a06764a6
|
File details
Details for the file soulprint_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: soulprint_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.9 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 |
96a0036bf5484afcb843d06efc0c4c54cf8c88b0dfa89f454b7e3be4248d2b88
|
|
| MD5 |
149a52d779440f3ecb65e4d0f90f12ec
|
|
| BLAKE2b-256 |
a7262c7ba9bf75517e827f6143cedfa294eb7e49a3273e64318d2b41605e4eff
|