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

# Clone and setup
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

# Run the server
python smcp/mcp_server.py

Clone and setup

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

Run the server

python smcp/mcp_server.py


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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


Verify Installation
# Clone and setup
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

# Run the server
python smcp/mcp_server.py
Check if server is running
curl http://localhost:8000/health
Should return: {"status": "healthy", "version": "1.0.0"}


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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

⚙️ Basic Configuration

Environment Variables

# Clone and setup
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

# Run the server
python smcp/mcp_server.py

Server settings

SMCP_PORT=8000 SMCP_HOST=localhost SMCP_LOG_LEVEL=INFO

Plugin settings

SMCP_PLUGINS_DIR=./plugins SMCP_AUTO_DISCOVER=true


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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


Plugin Directory Structure


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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

smcp/ ├── plugins/ │ ├── botfather/ # Telegram integration │ ├── devops/ # Development tools │ └── custom/ # Your custom plugins └── smcp/ └── mcp_server.py # Main server


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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


🔌 Available Plugins
Built-in Plugins
BotFather Plugin: Telegram bot management and communication
DevOps Plugin: Development and deployment tools
System Plugin: Basic system operations and monitoring
Plugin Development
Plugin Development Guide - How to create custom plugins
Plugin API Reference - Plugin development API
Example Plugins - Sample plugin implementations
🛠️ CLI Tools
Server Management
# Clone and setup
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

# Run the server
python smcp/mcp_server.py
Start server
python smcp/mcp_server.py
Start with custom config
python smcp/mcp_server.py --config custom_config.json
List available tools
python smcp/mcp_server.py --list-tools


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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

Plugin Management

# Clone and setup
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

# Run the server
python smcp/mcp_server.py

List installed plugins

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

Test plugin functionality

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


### Verify Installation
bash
# Check if server is running
curl http://localhost:8000/health

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


📚 Documentation Links
Core Documentation
Installation Instructions - Detailed installation from the repository
Configuration Reference - Complete configuration options
API Documentation - MCP protocol and REST API reference
Plugin Development
Plugin Development - Creating custom plugins
Plugin Examples - Sample implementations
Plugin API - Development API reference
Integration
Letta Integration - Using with Letta agents
Custom Clients - Building MCP clients
Troubleshooting - Common issues and solutions
🔧 Common Tasks
Adding a New Plugin

Create plugin directory in plugins/
Implement plugin interface
Register tools and capabilities
Restart server to auto-discover


Connecting an AI Agent
Configure agent to use MCP protocol
Point to SMCP server endpoint
Authenticate using API keys
Start using available tools
Monitoring and Debugging

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

🆘 Getting Help

GitHub Issues: Report bugs and request features
Documentation: Complete SMCP documentation
Community: Join our Discord

📄 License

Code: AGPLv3 - GNU Affero General Public License v3.0
Documentation: CC-BY-SA 4.0 - Creative Commons Attribution-ShareAlike 4.0

Sanctum Letta MCP - The foundation of the SanctumOS ecosystem.