Which integrations are available for this server?

Allows managing Modal deployments, apps, containers, volumes, secrets, and environments via MCP tools.

How do I use Modal MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Modal MCP Server list my deployed apps" 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 Server

by Braullynn

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

Servidor MCP (Model Context Protocol) que conecta agentes de IA (como o Google Antigravity) à infraestrutura da Modal.com, permitindo gerenciar deployments, apps, containers, volumes, secrets e ambientes via ferramentas MCP.

Arquitetura

O projeto usa o SDK oficial do MCP para expor comandos da CLI modal como ferramentas MCP. A comunicação é feita via stdio (StdioServerTransport), ideal para integração com agentes que suportam subprocessos MCP.

Agente de IA (ex: Antigravity)
        |
    [MCP - stdio]
        |
Modal MCP Server (Node.js)
        |
    [CLI: modal]
        |
    Modal.com API

Related MCP server: Modal MCP Server

Estrutura do Projeto

modal-mcp/
├── build/                      # Código compilado (TypeScript → JavaScript)
│   ├── index.js
│   ├── tools/
│   │   ├── deploy.js
│   │   ├── container.js
│   │   ├── volume.js
│   │   ├── secret.js
│   │   ├── app.js
│   │   └── environment.js
│   └── utils/
│       └── exec.js
├── src/                        # Código-fonte TypeScript
│   ├── index.ts                # Entry point do servidor MCP
│   ├── tools/                  # Módulos de ferramentas MCP
│   │   ├── deploy.ts           # Deploy e execução de apps
│   │   ├── container.ts        # Gerenciamento de containers
│   │   ├── volume.ts           # Gerenciamento de volumes persistentes
│   │   ├── secret.ts           # Gerenciamento de secrets
│   │   ├── app.ts              # Gerenciamento de apps
│   │   └── environment.ts      # Gerenciamento de ambientes
│   └── utils/
│       └── exec.ts             # Utilitário de execução da CLI modal
├── package.json
├── tsconfig.json
└── README.md

Pré-requisitos

Node.js 18+
Conta no Modal.com e token de autenticação configurado (modal token set)
CLI do Modal instalada (pip install modal ou modal disponível no PATH)

Instalação

npm install
npm run build

Uso

Iniciar o servidor

npm start
# ou diretamente:
node build/index.js

O servidor escuta comandos MCP via stdin/stdout e se comunica com seu agente de IA.

Integração com Antigravity (opencode.json)

Exemplo de configuração no seu opencode.json para conectar o agente do Google Antigravity ao Modal MCP Server:

{
  "antigravityAgents": {
    "meu-agente": {
      "mcpServers": {
        "modal": {
          "command": "node",
          "args": ["caminho/para/modal-mcp/build/index.js"]
        }
      }
    }
  }
}

Ferramentas MCP Disponíveis

Deploy & Run

Ferramenta	Descrição
`modal_deploy`	Deploy de uma aplicação Modal a partir de um script Python
`modal_run`	Execução de função ou entrypoint local no Modal

App Management

Ferramenta	Descrição
`modal_app_list`	Lista apps em execução, deployed ou parados
`modal_app_history`	Histórico de deploys de um app
`modal_app_logs`	Logs de um app
`modal_app_stop`	Para permanentemente um app
`modal_app_rollback`	Redeploy de versão anterior
`modal_app_rollover`	Redeploy sem mudanças de código (novos containers)

Container Management

Ferramenta	Descrição
`modal_container_list`	Lista containers em execução
`modal_container_exec`	Executa comando dentro de um container
`modal_container_logs`	Logs de um container específico
`modal_container_stop`	Termina um container

Volume Management

Ferramenta	Descrição
`modal_volume_list`	Lista volumes
`modal_volume_create`	Cria um volume persistente
`modal_volume_delete`	Deleta um volume
`modal_volume_ls`	Lista arquivos/diretórios dentro de um volume
`modal_volume_put`	Upload de arquivo/diretório para um volume
`modal_volume_get`	Download de arquivos de um volume
`modal_volume_rm`	Remove arquivo/diretório de um volume
`modal_volume_rename`	Renomeia um volume

Secret Management

Ferramenta	Descrição
`modal_secret_list`	Lista secrets publicados
`modal_secret_create`	Cria um novo secret
`modal_secret_delete`	Deleta um secret

Environment Management

Ferramenta	Descrição
`modal_env_list`	Lista ambientes do workspace
`modal_env_create`	Cria um novo ambiente
`modal_env_delete`	Deleta um ambiente
`modal_env_update`	Atualiza configurações de ambiente
`modal_env_members_list`	Lista membros de ambiente restrito
`modal_env_members_update`	Adiciona/atualiza papel de membro
`modal_env_members_remove`	Remove membro de ambiente restrito

Fluxo de Funcionamento

O agente de IA (ex: Google Antigravity) envia requisições MCP via stdio
O servidor MCP recebe a requisição e identifica qual ferramenta foi chamada
A ferramenta monta o comando modal <subcomando> apropriado
O comando é executado via child_process.exec
O stdout do comando é retornado como resposta MCP

Scripts

Comando	Descrição
`npm run build`	Compila TypeScript para JavaScript (`tsc`)
`npm run dev`	Compila em modo watch (`tsc -w`)
`npm start`	Inicia o servidor MCP

Available Tools

30 tools

modal_app_historyB

Show an App's deployment history.

Inputs: appIdentifier (required), env.

modal_app_listA

List Apps that are running, deployed or recently stopped.

Inputs: env.

modal_app_logsC

Fetch logs for an App.

Inputs: appIdentifier (required), env, tail, since, +1 more.

modal_app_rollbackC

Redeploy a previous version of an App.

Inputs: appIdentifier (required), env, version.

modal_app_rolloverA

Redeploy an App to get new containers without code changes.

Inputs: appIdentifier (required), env, strategy.

modal_app_stopA

Permanently stop an App and terminate its running containers.

Inputs: appIdentifier (required), env.

modal_container_execB

Execute a command in a container.

Inputs: command (required), containerId (required).

modal_container_listA

List all containers that are currently running.

Inputs: env, appId.

modal_container_logsB

Fetch logs for a specific container.

Inputs: containerId (required), tail, since, source.

modal_container_stopB

Terminate a running container.

Inputs: containerId (required).

modal_deployC

Deploy a Modal application.

Inputs: appRef (required), env, tag, name, +1 more.

modal_env_createB

Create a new environment in the current workspace.

Inputs: name (required), restricted.

modal_env_deleteB

Delete an environment in the current workspace.

Inputs: name (required).

modal_env_listB

List all environments in the current workspace.

Inputs: env.

modal_env_members_listA

List the members of a restricted Environment.

Inputs: environment (required).

modal_env_members_removeB

Remove a member from a restricted Environment.

Inputs: member (required), environment (required), serviceUser.

modal_env_members_updateA

Add or update a member's role in a restricted Environment.

Inputs: role (required), member (required), environment (required), serviceUser.

modal_env_updateC

Update environment-level settings.

Inputs: currentName (required), newName, webSuffix.

modal_runC

Run a Modal function or local entrypoint.

Inputs: appRef (required), env, detach.

modal_secret_createC

Create a new secret.

Inputs: name (required), env, force, keyValues.

modal_secret_deleteC

Delete a named Secret.

Inputs: name (required), env.

modal_secret_listA

List your published secrets.

Inputs: env.

modal_volume_createB

Create a named, persistent modal.Volume.

Inputs: name (required), env.

modal_volume_deleteA

Delete a named Volume and all of its data.

Inputs: name (required), env.

modal_volume_getB

Download files from a modal.Volume object.

Inputs: remotePath (required), volumeName (required), env, localDest.

modal_volume_listB

List the details of all modal.Volume volumes in an Environment.

Inputs: env.

modal_volume_lsB

List files and directories in a modal.Volume volume.

Inputs: volumeName (required), env, path.

modal_volume_putB

Upload a file or directory to a modal.Volume.

Inputs: localPath (required), volumeName (required), env, force, +1 more.

modal_volume_renameB

Rename a modal.Volume.

Inputs: newName (required), oldName (required), env.

modal_volume_rmB

Delete a file or directory from a modal.Volume.

Inputs: remotePath (required), volumeName (required), env, recursive.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3.2/5.0

Scored 2026-08-02 07:51 across 30 tools

Disambiguation5/5

Each tool targets a distinct resource and action, with no overlapping purposes. The few similar operations (e.g., app_stop vs. container_stop) are clearly differentiated by resource scope and descriptions.

Naming Consistency4/5

The predominant pattern modal_<resource>_<action> is consistent across most tools. Two tools (modal_deploy, modal_run) omit the resource prefix, causing minor deviation, but the overall scheme remains predictable and readable.

Tool Count3/5

With 30 tools, the set is above the ideal 3-15 range and falls into the heavy category. However, the broad scope of Modal (environments, apps, secrets, volumes, containers, deployments) justifies the number, even though it feels dense.

Completeness4/5

The tool surface covers most lifecycle operations for each resource: environments have full CRUD, apps have management and deployment actions, volumes include file operations, and containers have exec/logs/stop. A notable gap is the lack of a secret update operation, but agents can work around by deleting and recreating.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mcp
com.skopik
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Agent Orchestration Knowledge & Memory Search
2
https://api.skopik.com/mcp
Aident Loadout
io.github.Aident-AI
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Agent Orchestration App Automation
15
https://loadout.aident.ai/mcp
ClawLink
dev.claw-link
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
App Automation Workplace & Productivity
24
https://claw-link.dev/api/mcp
Flowra
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11
https://mcp.flowra.dev/mcp

Related MCP Servers

Modal MCP Server
Cloud Platforms Agent Orchestration Code Execution
smehmood
A
license
A
quality
D
maintenance
An MCP server that enables AI agents to interact with Modal, allowing them to deploy apps and run functions in a serverless cloud environment.
Updated 2 years ago (2025-03-25 22:53 UTC)
7
3
MIT
Modal MCP Server
Cloud Platforms Multimedia Processing Observability
IsaiahDupree
A
license
A
quality
C
maintenance
Exposes Modal cloud functions as MCP tools for video rendering, voice synthesis, and app management. Enables LLM agents to execute Remotion renders, F5-TTS voice cloning, and monitor Modal applications via Supabase-backed infrastructure.
Updated 2 months ago (2026-08-29 00:06 UTC)
6
MIT
@willpowell8/cursor-cloud
Coding Agents Developer Tools Version Control
willpowell8
A
license
Not graded
quality
Not graded
maintenance
Enables programmatic control of Cursor's cloud-based AI agents for automated code generation and repository management via standardized MCP tools.
Updated 10 months ago (2026-01-05 20:14 UTC)
27 npm
6
MIT
Modal MCP
CI/CD & DevOps Cloud Platforms Networking & Infrastructure
george-bobby
A
license
A
quality
B
maintenance
An MCP server for managing Modal — apps, containers, volumes, and secrets — and for deploying & running Modal apps directly from Claude Code and other MCP clients.
Updated 2 months ago (2026-09-09 10:08 UTC)
12
85 PyPI
4
MIT

Modal MCP Server

Arquitetura

Estrutura do Projeto

Pré-requisitos

Instalação

Uso

Iniciar o servidor

Integração com Antigravity (opencode.json)

Ferramentas MCP Disponíveis

Deploy & Run

App Management

Container Management

Volume Management

Secret Management

Environment Management

Fluxo de Funcionamento

Scripts

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Modal MCP Server

Modal MCP Server

@willpowell8/cursor-cloud

Modal MCP