Forge MCP Server

Laravel Forge MCP server for managing servers, sites, and deployments

Local serverstdio

What is the Forge MCP server?

Laravel Forge MCP server for managing servers, sites, and deployments. The forge mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

A Model Context Protocol (MCP) server for interacting with Laravel Forge API. This server enables AI assistants to manage Laravel Forge servers, sites, and deployments.

  • List and get details of Laravel Forge servers
  • Manage sites on Laravel Forge servers
  • Deploy sites and manage deployment scripts
  • Toggle quick deploy functionality
  • View deployment history
  • Reboot servers and check server load

Its toolset

Everything the assistant can do here goes through one of these:

  • list_servers — List all Laravel Forge servers
  • get_server — Get details of a specific server
  • list_sites — List all sites on a server
  • get_site — Get details of a specific site
  • deploy_site — Deploy a site
  • get_deployments — Get deployment history for a site
  • get_deployment_script — Get the deployment script for a site
  • update_deployment_script — Update the deployment script for a site
  • toggle_quick_deploy — Enable or disable quick deploy for a site
  • reboot_server — Reboot a server
  • get_server_load — Get server load metrics
  • reset_deployment_state — Reset deployment state for a site

Configuration

You will need one environment variable: FORGE_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

You need a Laravel Forge API key to use this server. You can get one from your Laravel Forge account settings.

Adding it to your client

The server ships on npm as forge-mcp-server, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

When to reach for it

Among the cloud and infrastructure options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Forge's toolset — list_servers, get_server, list_sites and 11 more — is a fair guide to whether it matches your workflow. It is maintained by bretterer; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Forge's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Forge.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the forge mcp server does with a few real requests.

Available tools

ToolWhat it does
list_serversList all Laravel Forge servers
get_serverGet details of a specific server
list_sitesList all sites on a server
get_siteGet details of a specific site
deploy_siteDeploy a site
get_deploymentsGet deployment history for a site
get_deployment_scriptGet the deployment script for a site
update_deployment_scriptUpdate the deployment script for a site
toggle_quick_deployEnable or disable quick deploy for a site
reboot_serverReboot a server
get_server_loadGet server load metrics
reset_deployment_stateReset deployment state for a site
PrerequisitesYou need a Laravel Forge API key to use this server. You can get one from your [Laravel Forge account settings](https://forge.laravel.com/user/profile#/api).
SetupThe Setup tool exposed by this server.

How to install the Forge MCP server

{
  "mcpServers": {
    "forge-1": {
      "command": "npx",
      "args": ["-y", "forge-mcp-server"],
      "env": {
        "FORGE_API_KEY": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

You need a Laravel Forge API key to use this server. You can get one from your Laravel Forge account settings.

VariableDescriptionRequired
FORGE_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Forge to list servers.
  • Use Forge to get server.
  • Use Forge to list sites.

Frequently asked questions

It connects Forge to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (list_servers, get_server, list_sites, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Forge directly.