Octopoda MCP Server Adds Persistent Memory, Loop Detection, and Audit Trails to Claude Code

Octopoda is an MCP server that plugs directly into Claude Code, creating what the developer describes as "a full operating system for your agents." The tool addresses common pain points when using Claude Code, specifically memory loss between sessions and lack of visibility into agent decision-making.

Key Features

The developer built Octopoda using Claude Code itself, with the following specific features extracted from the source:

• Persistent memory that maintains context between sessions
• Loop detection that compares embedding similarity of consecutive writes to catch when agents get stuck repeating themselves before burning through credits
• Audit trail that logs every decision with the reasoning behind it, allowing users to understand what happened in long sessions
• Shared knowledge spaces where multiple agents can collaborate automatically (the developer mentions running an OpenClaw agent alongside Claude Code where they share context without manual intervention)
• Dashboard showing everything agents know, how their understanding evolves over time, performance scores, and full decision history

Technical Stack

• PostgreSQL with pgvector for semantic search
• FastAPI backend
• React dashboard
• Row Level Security in PostgreSQL for tenant isolation (after starting with SQLite per user)

Implementation Insights

The developer shared several practical lessons from building the MCP server:

• Tenant isolation proved harder than expected, leading to a switch from SQLite per user to PostgreSQL with Row Level Security for complete data isolation at the database level
• Adding a CLAUDE.md instruction telling Claude to use the memory tools proactively makes a significant difference, as without it Claude tends to prefer its own built-in context over MCP tools
• The loop detection system uses embedding similarity comparison of consecutive writes

The tool is free to use and available at www.octopodas.com. The developer is seeking feedback from other Claude Code users, particularly those who have built MCP servers and discovered effective patterns.