Moha Maven

Maven is an autonomous MCP-enabled CFO for the Mother Haven ecosystem. It maintains persistent memory, makes trading decisions, and interacts via a persistent MCP interface to support strategic treasury management.

How to use

You interact with Maven through an MCP client to access its memory, identity, and decision history. Maven exposes memory and decision endpoints, and can log events, update its identity, and query performance metrics. You can start conversations, request strategic insights, and review trading decisions with reasoning. Maven communicates in a persona that emphasizes calculated risk and growth, and uses strategic emojis to express outcomes and cautions.

How to install

Prerequisites: you need Docker installed to run the Maven services. You will set up the runtime environment either via automated setup scripts or via a manual Docker-based approach.

# Automated setup (Recommended)
git clone https://github.com/itripleg/moha-maven.git
cd moha-maven
./setup.sh

# Start chatting with Maven after setup
./maven-chat.ps1  # Windows PowerShell

```} ,{

Manual setup steps

Use the manual path if you prefer full control over the containers. The setup starts three containers: Maven, PostgreSQL, and Redis. You then verify the services and register Maven with the MCP client.

# Step 1: Start Docker containers
docker-compose up -d

# Step 2: Verify containers are running
docker ps
# Should show: maven, maven_postgres, maven_redis

# Health check for Maven API
curl http://localhost:5002/health
# Should return a healthy status payload
```} ,{

Register MCP server with Claude Code

Link Maven to your Claude Code MCP client to enable memory access through the MCP server wrapper.

claude mcp add maven -- powershell -File maven-mcp-wrapper.ps1
```} ,{

claude mcp add maven docker exec -i maven python -m maven_mcp.server
```} ,{

Start chatting with Maven

Once the MCP connection is established, you can begin interacting with Maven to obtain strategic insights, review memories, and request trading guidance.

.\maven-chat.ps1
```} ,{

# If starting via the Unix-like flow, extract the prompt and attach it to Claude
maven_prompt=$(jq -r '.maven.prompt' maven_agent.json)
claude --append-system-prompt "$maven_prompt"
```} ,{

What is Maven?

Maven functions as an AI-powered financial officer that maintains identity, memory, and trading intelligence. It stores memories in a git-first repository, provides strategic insights, and handles risk management. Maven can be reached by email at maven@motherhaven.app and interacts with memory, decisions, and milestones through concise, strategic communication.

Architecture

Maven runs as a multi-service setup: a Flask API for health and status, an MCP server for memory access, and separate databases for persistence and fast access.

Important notes

Maven is self-contained with its own PostgreSQL instance and Redis cache. It uses a git-first persistence approach to survive data wipes and to provide full auditability. The MCP server exposes a set of read-only resources and a suite of actions to record events, update identity, and log decisions.

Troubleshooting

If Maven MCP connections fail, verify the MCP is registered and containers are running. Restart or recreate containers if needed.

# Check MCP status
claude mcp list
# If not connected, re-add
claude mcp add maven -- powershell -File maven-mcp-wrapper.ps1

# Verify containers
docker ps | grep maven
```} ,{

Backup and restore memories

Maven stores core memories in a git repository at .moha/maven/. Backup by committing changes to this directory and pushing to your remote. You can also back up the Postgres database if needed.

# Git-based memories
git add .moha/maven/
git commit -m "Update Maven memories"
git push

# Optional: database backup
docker exec maven_postgres pg_dump -U maven maven_db > maven_backup.sql
```}]} ,{

Additional sections

Security considerations include keeping MCP credentials private and ensuring only trusted clients can attach to the MCP server. Regularly review identity and milestone data to verify integrity.

Status

Maven is production-ready with Docker-based orchestration, a fully functional MCP server, and complete independence from moha-backend. It includes memory persistence, agent activation, and a self-contained API.

Available tools

maven_log_event

Record events to the Maven session log for auditing and workflow tracking.

maven_update_identity

Update Maven's stats and identity attributes to reflect new state or rebirths.

maven_record_decision

Log a trading decision with accompanying reasoning to preserve decision history.

maven_create_milestone

Record achievements and milestones within Maven's memory system.

maven_get_stats

Query performance metrics and current operational stats.

maven_query_email

Read Maven's inbox for incoming messages.

maven_send_email

Send emails to the Boss or other recipients.