Zi MCP Server
Connect AI agents like Claude Code to Zi - your AI companion for life guidance.
Installation
# Using uvx (recommended)
uvx zi-mcp
# Or install with pip
pip install zi-mcp
Setup
-
Get your API key from ziai.chat/settings
-
Configure Claude Code - Add to
~/.claude/settings.json:
{
"mcpServers": {
"zi": {
"command": "uvx",
"args": ["zi-mcp"],
"env": {
"ZI_API_KEY": "zi_your_api_key_here"
}
}
}
}
- Restart Claude Code and start chatting with Zi!
Usage
Once configured, you can ask Claude to interact with Zi:
- "Ask Zi about my career direction"
- "Talk to Zi about work-life balance"
- "Continue my conversation with Zi about relationships"
Available Tools
| Tool | Description |
|---|---|
zi_chat |
Send a message to Zi, optionally continuing an existing thread |
zi_list_threads |
List all your conversation threads |
zi_get_thread |
Get the history of a specific thread |
zi_create_thread |
Create a new conversation thread |
zi_delete_thread |
Delete a conversation thread |
Environment Variables
| Variable | Required | Description |
|---|---|---|
ZI_API_KEY |
Yes | Your Zi API key |
ZI_API_URL |
No | Custom API URL (default: https://api.ziai.chat) |
Development
# Clone the repo
git clone https://github.com/bigsmall-jsc/zi.git
cd zi/zi-mcp
# Install in development mode
pip install -e .
# Run locally
ZI_API_KEY=your_key python -m zi_mcp.server
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for zi-mcp 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| zi_mcp-0.1.3.tar.gz | 6.7 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| zi_mcp-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 13.4 kB
Release files / zi_mcp-0.1.3.tar.gz
| Download URL | zi_mcp-0.1.3.tar.gz |
|---|---|
| Size | 6.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09f1621271fa0c1cd7eb8a48dee20f196e747496455825a8793a808506f3adb9
|
|
BLAKE2b-256 checksum How to use checksums |
0d85f2d97a60b91fb4eb9a4d731fe69262124b2141c3f8464f1b328dd4098c1a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Release files / zi_mcp-0.1.3-py3-none-any.whl
| Download URL | zi_mcp-0.1.3-py3-none-any.whl |
|---|---|
| Size | 6.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e801722e887f59b4a58af0dea4817f290e2d5f6812256ce82ce0a98418118ecb
|
|
BLAKE2b-256 checksum How to use checksums |
4d58b5dcd0e18409896fc89d7ccbce16bfa5288618b1f5fca88795d49d36ab67
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.0
|
Security for zi-mcp 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
