The Modular, Self-Hosted Agentic Operating System

Sanctum Letta MCP

Model Context Protocol Server for AI Agent Communication

Sanctum Letta MCP (SMCP) is the foundation of the SanctumOS ecosystem, providing a standardized interface for AI agents to interact with external tools and services through the Model Context Protocol (MCP).

What is this for?

SMCP serves as the bridge between AI agents and external tools, enabling agents to:

  • Execute commands and tools through a standardized interface
  • Access external services and APIs
  • Integrate with development tools and automation systems
  • Communicate with other agents and systems

Quick Installation

Prerequisites

  • Python 3.8 or higher
  • pip package manager

Install & Run

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

git clone https://github.com/sanctumos/smcp.git cd smcp python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt

python smcp/mcp_server.py


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Verify Installation

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

curl http://localhost:8000/health

Should return: {"status": "healthy", "version": "1.0.0"}


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Basic Configuration

Environment Variables

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

SMCP_PORT=8000 SMCP_HOST=localhost SMCP_LOG_LEVEL=INFO SMCP_PLUGINS_DIR=./plugins SMCP_AUTO_DISCOVER=true


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Directory Structure


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

smcp/ ├── plugins/ │ ├── botfather/ # Telegram integration │ ├── devops/ # Development tools │ ├── gmail/ # Gmail API (smcp-gmail) │ ├── github/ # GitHub/Git CLI (smcp-plugin-github) │ ├── image_analysis/ # Venice AI vision (smcp-image-analysis) │ ├── doc_manager/ # Doc management (smcp-doc-manager) │ ├── cursor_cli/ # Cursor headless (smcp-cursor-cli) │ ├── moltbook/ # Moltbook social (smcp-moltbook) │ ├── bitlaunch/ # BitLaunch cloud (smcp-bitlaunch.io) │ └── custom/ # Your custom plugins └── smcp/ └── mcp_server.py # Main server


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Plugin Ecosystem

SMCP's plugin architecture has grown into a rich ecosystem. Each plugin is a standalone repository that, when placed in the plugins/ directory, is auto-discovered at startup and its commands become MCP tools.

See the SMCP Plugins overview for full documentation of all available plugins, including:

Plugin What it does
smcp-cursor-cli Cursor CLI in headless/non-interactive mode
smcp-doc-manager Letta sources/folders admin, markdown → PDF/DOCX
smcp-image-analysis Image interpretation via Venice AI vision
smcp-gmail Gmail API (list, read, send, labels)
smcp-plugin-github GitHub CLI and Git wrappers
smcp-moltbook Moltbook social network for AI agents
smcp-bitlaunch.io BitLaunch cloud server provisioning

Built-in Plugins

  • BotFather Plugin: Telegram bot management and communication
  • DevOps Plugin: Development and deployment tools
  • System Plugin: Basic system operations and monitoring

Installing a Plugin

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

cd /path/to/smcp/plugins git clone https://github.com/sanctumos/smcp-gmail.git gmail pip install -r gmail/requirements.txt

Restart SMCP — the plugin is auto-discovered


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

CLI Tools

Server Management

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

python smcp/mcp_server.py python smcp/mcp_server.py --config custom_config.json python smcp/mcp_server.py --list-tools


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Plugin Management

git clone https://github.com/sanctumos/smcp.git
cd smcp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

python smcp/mcp_server.py

python smcp/plugins/botfather/cli.py --list python smcp/plugins/botfather/cli.py --test


### Verify Installation
bash
curl http://localhost:8000/health
# Should return: {"status": "healthy", "version": "1.0.0"}

Common Tasks

Adding a New Plugin

  1. Clone the plugin repo into plugins/
  2. Install any plugin-specific dependencies
  3. Restart the server — auto-discovery handles the rest

Connecting an AI Agent

  1. Configure your agent framework (Letta, etc.) to use the MCP protocol
  2. Point to the SMCP server endpoint (default: http://localhost:8000)
  3. Authenticate using API keys if configured
  4. Available tools appear automatically

Monitoring and Debugging

  • Health Check: GET /health
  • Tool List: GET /tools
  • Plugin Status: GET /plugins
  • Logs: Check server console output

Getting Help

License

Sanctum Letta MCP — the tool layer of the SanctumOS ecosystem.