Archived: There's been many significant improvements to agentic frameworks since I first made this server, many of it's features are implemented natively in most agents today

Axom MCP Server

Axom is a Model Context Protocol (MCP) server that provides persistent memory, tool abstraction, and chain-of-thought for AI agents.

Core Features

• Persistent Memory: Store and retrieve context across sessions using the Axom (SQLite) database.

• Tool Abstraction: Unified interface for memory, execution, analysis, discovery, and transformation.

• Chain Reactions: Execute tool sequences where outputs feed into the next step.

• AI-Powered Classification: Automatically categorizes memories by type and importance.

Quick Start

Axom runs as stdio MCP - your IDE spawns it automatically. No manual server startup needed.

Prerequisites

• Python 3.11+

• SQLite (included with Python)

• Git

Installation

Linux / macOS / WSL / Windows

Requires (Git) Bash, PowerShell, or a make provider.

git clone https://github.com/PugzUI/axom-mcp.git
cd axom-mcp
make install

What make install does:

1. Installs Python dependencies.

2. Installs Axom in editable mode (pip install -e .).

3. Creates .env from .env.example.

4. Configures all detected agents (Cursor, Trae, etc.).

5. Installs Axom rules and skills for each agent.

Make Command Menu - Overview

make help              # Project command menu
make install-help      # Install options (e.g. DRY_RUN, etc.)
make clean-help        # Cleanup options (incl. CLEAN_ALL=1 for full reset)
make agents-help       # Agent commands
make db-help           # Database commands
make test-help         # Test commands

Ruff Dev Tool Commands

make lint-help         # Lint commands (ruff dev tool)
make format-help       # Format commands (ruff dev tool)

Client Configuration

make install automatically configures MCP for detected agents. The installer uses the best available command:

1. **axom-mcp** (if in PATH)

2. **axom** (if in PATH)

3. **python -m axom_mcp.server** (fallback)

See docs/agents/INDEX.md for detailed agent configuration.

For Cursor, ~/.cursor/mcp.json should contain:

{
  "mcpServers": {
    "axom": {
      "command": "axom-mcp"
    }
  }
}

For Codex, ~/.codex/config.toml should contain:

[mcp_servers.axom]
command = "axom-mcp"

Tools

Axom provides five core MCP tools:

• **axom_mcp_memory**: Store and retrieve persistent context.

• **axom_mcp_exec**: File operations and shell commands with pre-meditated chaining.

• **axom_mcp_analyze**: Code analysis and debugging.

• **axom_mcp_discover**: Map environment and capabilities.

• **axom_mcp_transform**: Convert data between formats.

Documentation

• Architecture - System design and data flow.

• Tool Reference - Detailed tool parameters.

• Agent Guide - How to use Axom with AI agents.

• Troubleshooting - Common issues and fixes.