🚂 Letta MCP Server Railway Edition

Cloud-optimized HTTP transport edition of Letta MCP Server - Deploy to Railway in 30 seconds.

Universal MCP server connecting any AI client to Letta.ai's powerful stateful agents via streamable HTTP for seamless cloud deployment.

🚀 Quick Deploy to Railway

Prerequisites

• Letta API key from api.letta.com (free tier available)

• Railway account (free tier includes 500 hours/month)

One-Click Deployment

1. Click the deploy button above

2. Connect your GitHub account to Railway

3. Add environment variable: LETTA_API_KEY=your_letta_api_key_here

4. Deploy - your MCP server will be live in under 2 minutes!

Your MCP Server URL

Related MCP server: AgentCraft MCP Server

⚡ Integration with AI Clients

Claude Desktop (ADE Integration)

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

MCP Inspector Testing

Test your deployment with the MCP Inspector:

GitHub Copilot & VS Code

Other MCP Clients

• Cursor: Add server to MCP configuration

• Replit: Use MCP-compatible endpoint configuration

• Sourcegraph Cody: Configure via OpenCtx bridge

• Any MCP Client: Use streamable HTTP transport

🔧 Configuration

Environment Variables

Letta Cloud Setup

1. Sign up: Create account at letta.com

2. Get API key: Visit api.letta.com → Settings → API Keys

3. Create agent: Use the web interface to create your first agent

4. Test connection: Use letta_health_check tool to verify

🛠️ Available Tools (20+ Letta Functions)

🤖 Agent Management

• letta_list_agents - List all agents with pagination and filtering

• letta_create_agent - Create new agents with memory blocks and tools

• letta_get_agent - Get detailed agent information

• letta_update_agent - Update agent configuration (name, description, model)

• letta_delete_agent - Safely delete agents with confirmation

💬 Conversations

• letta_send_message - Send messages to agents with streaming support

• letta_get_conversation_history - Retrieve chat history with pagination

• letta_export_conversation - Export conversations (markdown, JSON, text)

🧠 Memory Management

• letta_get_memory - View all memory blocks for an agent

• letta_update_memory - Update memory blocks (human, persona, custom)

• letta_create_memory_block - Create custom memory blocks

• letta_search_memory - Search through agent conversation memory

🔧 Tool Management

• letta_list_tools - List all available tools with filtering

• letta_get_agent_tools - View tools attached to specific agents

• letta_attach_tool - Add tools to agents

• letta_detach_tool - Remove tools from agents

📊 Monitoring & Health

• letta_health_check - Verify API connection and service status

• letta_get_usage_stats - Get usage statistics and analytics

🏗️ Technical Architecture

Railway-Optimized Features

• Streamable HTTP Transport: Optimized for cloud deployment vs stdio

• Connection Pooling: Maintains persistent connections for performance

• Auto-scaling: Railway automatically scales based on demand

• Zero-downtime Deploys: Hot reloading without connection loss

• Built-in Monitoring: Railway dashboard shows metrics and logs

Performance Optimizations

Transport Comparison

💻 Local Development

Quick Local Setup

Local Testing

Development Commands

🔍 Troubleshooting

Common Issues

1. "Connection refused" error

2. "Invalid API key" error

3. "Timeout" errors

4. Claude Desktop not connecting

• Restart Claude Desktop after configuration changes

• Check configuration file syntax with a JSON validator

• Verify the URL is accessible from your browser

Getting Help

1. Check Railway logs: View deployment logs in Railway dashboard

2. Test health endpoint: Visit https://your-app.up.railway.app/health

3. Verify MCP endpoint: Test with MCP Inspector

4. Community support: Join Letta Discord

5. Report issues: GitHub Issues

🚀 Production Deployment

Railway Deployment Best Practices

Environment Management

Health Monitoring

Railway provides built-in monitoring, but you can also:

• Set up custom health checks

• Monitor response times and error rates

• Configure alerts for downtime

Scaling Configuration

📖 Resources

Documentation

• Letta Documentation - Complete Letta platform guide

• MCP Specification - Model Context Protocol standard

• Railway Documentation - Railway platform guide

• FastMCP Documentation - HTTP transport framework

Community & Support

• Letta Discord - Active community support

• MCP Community - Protocol development

• Railway Community - Deployment support

• GitHub Issues - Bug reports and features

Examples & Tutorials

• Letta Agent Examples - Sample agent configurations

• MCP Client Integration - Client setup guides

• Railway Templates - Deployment templates

🤝 Contributing

We welcome contributions to make Letta MCP Server Railway even better!

Quick Contribution Guide

1. Fork the repository

2. Create a feature branch: git checkout -b feature/amazing-feature

3. Make your changes and add tests

4. Test locally: pytest tests/

5. Commit with clear messages: git commit -m "Add amazing feature"

6. Push to your fork: git push origin feature/amazing-feature

7. Submit a Pull Request

Development Setup

Areas We Need Help

• 📖 Documentation improvements

• 🧪 Additional test coverage

• 🔧 Railway deployment optimizations

• 🌐 Multi-language client examples

• 🐛 Bug fixes and performance improvements

📜 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built with ❤️ by the community for seamless AI agent deployment.

Special Thanks:

• Letta.ai for revolutionary stateful agents

• Railway for exceptional deployment platform

• Anthropic for MCP specification leadership

• FastMCP for HTTP transport framework

• All contributors making this project possible