Metadata-Version: 2.5
Name: soulprint-mcp
Version: 0.2.0
Summary: MCP server for SoulPrint Engine — your identity and memories in every AI agent
Project-URL: Homepage, https://soulprintengine.ai
Project-URL: Repository, https://github.com/coolgeekme/soulprint-mcp
Project-URL: Issues, https://github.com/coolgeekme/soulprint-mcp/issues
Author-email: Cool Geek Media LLC <reggie@coolgeek.me>
License: MIT
Keywords: agent,ai,identity,mcp,memory,soulprint
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# 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

```bash
pip install soulprint-mcp
# or
uvx soulprint-mcp
```

## Setup

1. **Get your API token** — open the SoulPrint Chrome extension, connect your
   account, and copy your token. Or visit https://soulprintengine.ai/settings/tokens

2. **Add to your agent:**

**Claude Code** — run in your terminal:
```bash
claude mcp add soulprint -- uvx soulprint-mcp --token YOUR_TOKEN
```

**Codex** — add to `~/.codex/config.toml`:
```toml
[mcp_servers.soulprint]
command = "uvx"
args = ["soulprint-mcp", "--token", "YOUR_TOKEN"]
```

**Cursor** — add to `.cursor/mcp.json`:
```json
{
  "mcpServers": {
    "soulprint": {
      "command": "uvx",
      "args": ["soulprint-mcp", "--token", "YOUR_TOKEN"]
    }
  }
}
```

**Hermes**:
```bash
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.
