mcp-server-exogram

mcp-name: io.github.Richard-Ewing/exogram

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

Tool	Description
exogram_evaluate_action	Request authorization for a tool call. Returns a token if ALLOWED, or blocks execution if it violates policy constraints.
exogram_commit_action	Commit an executed action token to the immutable audit ledger.
exogram_store_record	Store a fact/record in the encrypted trust vault (scrubs PII, matches conflicts).
exogram_search_records	Search vault records using semantic similarity.

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

Variable	Required	Default	Description
EXOGRAM_BEARER_TOKEN	Yes	—	Your Exogram API bearer token
EXOGRAM_API_URL	No	https://api.exogram.ai	Exogram API base URL

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.