Modal MCP Server
The Modal MCP Server provides an interface to Modal cloud computing, enabling AI agents to render videos, synthesize speech, manage jobs, and monitor deployments.
Video Rendering — Render Remotion compositions (e.g.,
instagram_ugc_v1,explainer_v1,tiktok_v1) on Modal's cloud with configurable quality (preview/production), style overrides, and resolution settings. Results are uploaded to Supabase Storage and a public MP4 URL is returned.Voice Synthesis — Generate speech via F5-TTS voice cloning (Isaiah voice by default) with configurable speed (0.5–2.0x) and sampling temperature. Returns an audio URL or base64-encoded audio.
GPU Computing — Dispatch general-purpose GPU tasks to Modal's cloud infrastructure.
Job Management — Submit, list, retrieve, and cancel jobs; track status and results with persistent storage via Supabase or an in-memory fallback.
Modal App Monitoring — List all deployed Modal apps with their status, task count, and creation date.
Log Tailing — Retrieve recent logs from any Modal app (e.g.,
remotion-render,voice-clone) with a configurable line count.Health Checks — Monitor server and dependency status via
/api/health.Built-in Safeguards — Rate limiting (100 req/min per IP), input validation, and CORS configuration for secure interactions.
Exposes Modal cloud functions as tools, enabling video rendering of Remotion compositions, speech synthesis via F5-TTS voice cloning, and management of Modal apps and logs.
Integrates with Supabase Storage to persist rendered video files (MP4/PNG) and uses Supabase database to store and retrieve render job metadata and history.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Modal MCP ServerRender the intro video in 1080p using my Main composition"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
modal-mcp
Complete MCP (Model Context Protocol) server for Modal cloud computing. Exposes render, voice, and GPU computing capabilities as tools for Claude and LLM agents.
Status: Production-ready (28/65 features complete)
Overview
Modal MCP provides:
Video Rendering — Remotion compositions on Modal's cloud infrastructure
Voice Synthesis — F5-TTS voice cloning for audio generation
GPU Computing — General GPU task dispatch
Job Management — Full job lifecycle with status tracking
Health Monitoring — Real-time dependency status
Rate Limiting — Built-in protection against abuse
Supabase Integration — Persistent job storage
Related MCP server: LangChain Anthropic MCP Server
Quick Start
1. Install and Configure
# Install dependencies
npm install
# Copy and edit environment file
cp .env.example .env
# Edit .env with your Supabase and Modal URLs2. Start Server
npm start # Production mode
npm run dev # Development with verbose loggingServer runs on http://localhost:3001
3. Test It Works
# Health check
curl http://localhost:3001/api/health | jq .
# Run test suite
npm run test:allAPI Endpoints
Health Check
GET /api/healthReturns server status and dependency health.
Job Management
POST /api/jobs # Submit a job
GET /api/jobs # List jobs
GET /api/jobs/:id # Get job status
GET /api/jobs/:id/result # Get job result (if done)
DELETE /api/jobs/:id # Cancel pending jobMCP Tools
Tool | Description |
| Render Remotion composition on Modal → Supabase Storage |
| List past render jobs |
| Get single render job details |
| Synthesize speech via F5-TTS voice clone |
| List deployed Modal apps |
| Tail logs from a Modal app |
Configuration
Environment Variables
# Supabase (required for persistence)
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-service-role-key
# Modal Endpoints
MODAL_REMOTION_RENDER_URL=https://your-account--remotion-render.modal.run
MODAL_VOICE_CLONE_URL=https://your-account--voice-clone.modal.run
MODAL_BIN=modal
# Server
PORT=3001
LOG_LEVEL=info # debug, info, warn, errorDocker Setup
docker build -t modal-mcp:latest .
docker run -p 3001:3001 \
-e SUPABASE_URL=... \
-e SUPABASE_KEY=... \
modal-mcp:latestIntegration with Claude
Add to Claude's settings.json:
{
"mcpServers": {
"modal-mcp": {
"command": "node",
"args": ["/path/to/modal-mcp/server.js"],
"env": {
"SUPABASE_URL": "https://your-project.supabase.co",
"SUPABASE_KEY": "your-key",
"MODAL_REMOTION_RENDER_URL": "https://your-modal-endpoint.modal.run"
}
}
}
}Features Implemented
Phase 1: Infrastructure & Health Checks ✅
MCP Server Initialization (INFRA-001)
Environment Configuration (INFRA-002)
Logging System (INFRA-003)
Health Check Endpoint (API-001)
Error Handling Middleware (API-002)
Phase 2: Job Management ✅
Job Submission API (JOB-001)
Job Status Polling (JOB-002)
Job Result Retrieval (JOB-003)
Job Cancellation (JOB-004)
Job Queue Management (JOB-005)
API Rate Limiting (API-003)
Input Validation (SECURITY-001)
CORS Configuration (SECURITY-002)
Phase 3: Render Pipeline ✅
Remotion Render Job Submission (RENDER-001)
Render Quality Configuration (RENDER-002)
Voice Clone Job Submission (VOICE-001)
Voice Clone Result Retrieval (VOICE-002)
GPU Task Dispatch (GPU-001)
Phase 4-6: In Progress
Testing features (unit, integration, end-to-end)
Database schema and optimization
Deployment documentation
Monitoring and observability
Testing
# Unit tests (10 tests, all passing)
npm run test
# API integration tests
npm run test:api
# Run all tests
npm run test:allDocumentation
DEPLOYMENT.md — Docker, Vercel, Kubernetes, monitoring, scaling
docs/DATABASE.md — Supabase schema setup and migration
Examples
Submit a Render Job
curl -X POST http://localhost:3001/api/jobs \
-H "Content-Type: application/json" \
-d '{
"type": "render",
"composition": "explainer_v1",
"sections": [
{
"id": "1",
"type": "hook",
"duration_sec": 3,
"content": {"text": "Hello World"}
}
],
"quality": "production"
}'Check Job Status
curl http://localhost:3001/api/jobs/abc12345Get Render Result
curl http://localhost:3001/api/jobs/abc12345/resultPerformance
Rate Limiting: 100 requests/minute per IP
Job Timeouts: 10 minutes (render), 2 minutes (voice)
In-Memory Store: Fallback when Supabase unconfigured
Structured Logging: JSON logs with timestamps
Architecture
┌─────────────────────────────────────┐
│ Claude / LLM Agent │
└─────────────┬───────────────────────┘
│ MCP Protocol
▼
┌─────────────────────────────────────┐
│ Modal MCP Server │
├─────────────────────────────────────┤
│ HTTP Layer (3001) │
│ • Health checks │
│ • Job management │
│ • Rate limiting │
├─────────────────────────────────────┤
│ MCP Tool Layer │
│ • Render (Remotion) │
│ • Voice (F5-TTS) │
│ • GPU tasks │
├─────────────────────────────────────┤
│ Storage Layer │
│ • Supabase (persistent) │
│ • In-Memory (fallback) │
└─────────────┬───────────────────────┘
│
┌─────────┴──────────┬──────────────┐
▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌────────────┐
│ Modal │ │Supabase │ │ Storage │
│Endpoints │ │Database │ │ (S3/GCS) │
└──────────┘ └──────────┘ └────────────┘License
MIT
Support
Issues: GitHub issues
Documentation: See DEPLOYMENT.md and docs/
Examples: See test-api.sh
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to interact with Modal, allowing them to deploy apps and run functions in a serverless cloud environment.Last updated73MIT
- Alicense-quality-maintenanceExposes LangChain and Anthropic Claude capabilities as tools for generating production-ready RAG systems, Supabase vector stores, and document ingestion pipelines. It enables users to instantly scaffold AI infrastructure and document processing code through natural language prompts in MCP-compatible clients.Last updated
- Flicense-qualityCmaintenanceConnects AI agents to Modal.com infrastructure, allowing management of deployments, apps, containers, volumes, secrets, and environments via MCP tools.Last updated
- AlicenseAqualityBmaintenanceMCP tools for video transcoding, document conversion, and multi-step pipelines — callable by any AI agent.Last updated12821MIT
Related MCP Connectors
OCR, transcription, file extraction, and image generation for AI agents via MCP.
The agent-native cloud: database, functions, AI, storage, auth and more. 46 tools, one API key.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/IsaiahDupree/modal-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server