Exogram MCP Server

A Model Context Protocol (MCP) server providing tools to evaluate, commit, and audit agentic actions through the Exogram Authority Runtime.

This server enables AI models (like Claude Desktop) to request cryptographic authorization before executing state-changing tools and securely store/retrieve records in the Exogram vault.

Features

• Action Evaluation — Request cryptographic authorization before executing state-changing operations
• Audit Ledger — Commit executed actions to an immutable, tamper-proof audit trail
• Encrypted Vault — Store facts/records with encryption, PII scrubbing, and conflict detection
• Semantic Search — Search stored records using vector similarity

Tools

Installation

Using uv (recommended)

uv pip install mcp-server-exogram

Using pip

pip install mcp-server-exogram

Configuration

Claude Desktop

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "exogram": {
      "command": "uv",
      "args": [
        "run",
        "--package",
        "mcp-server-exogram",
        "mcp-server-exogram"
      ],
      "env": {
        "EXOGRAM_API_URL": "https://api.exogram.ai",
        "EXOGRAM_BEARER_TOKEN": "<YOUR_EXOGRAM_BEARER_TOKEN>"
      }
    }
  }
}

Using uvx

EXOGRAM_API_URL=https://api.exogram.ai \
EXOGRAM_BEARER_TOKEN=your-token \
uvx mcp-server-exogram

Environment Variables

Development

# Clone and setup
git clone https://github.com/Richard-Ewing/servers.git
cd servers/src/exogram

# Install dependencies
uv sync --all-extras --dev

# Run type checking
uv run pyright

# Run linting
uv run ruff check .

# Run tests
uv run pytest tests/

# Build package
uv build

License

MIT — see LICENSE for details.