home / mcp / laravel forge mcp server

Laravel Forge MCP Server

Compiles a minimal MCP server for Laravel Forge and provides an MCP config you can paste into your MCP client to connect and manage Forge data.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jordandalton-laravel-forge-mcp-server": {
      "command": "npx",
      "args": [
        "path/to/your/laravel-forge-mcp-server/build/bin.js"
      ],
      "env": {
        "FORGE_API_KEY": "<REPLACE>",
        "FORGE_SITE_ID": "<REPLACE>",
        "FORGE_SERVER_ID": "<REPLACE>"
      }
    }
  }
}

The Laravel Forge MCP Server lets you compile a minimal MCP server that connects Laravel Forge data to MCP clients. It builds a local server component and outputs a ready-to-use MCP configuration you can load into your MCP client to start interacting with Forge-related data and actions.

How to use

After you build the server, you obtain a build directory and a ready-to-use MCP configuration you can paste into your MCP client (Claude Desktop, Windsurf, Cursor, and others). The MCP client uses this configuration to start and connect to the Laravel Forge MCP Server, enabling you to manage Forge data through your preferred MCP interface.

How to install

Prerequisites: Node.js and npm must be installed on your system.

Step 1: Install dependencies and build the MCP server.

npm install && npm run build

Step 2: Locate the generated MCP configuration snippet. The build process outputs a JSON block you can copy into your MCP client to wire up the server.

Additional notes

During the build, the process generates a configuration example similar to the following. You should replace the placeholder values with your actual Forge credentials.

{
  "mcpServers": {
    "laravel-forge-mcp-server": {
      "command": "npx",
      "args": [
        "path/to/your/laravel-forge-mcp-server/build/bin.js"
      ],
      "env": {
        "FORGE_API_KEY": "<REPLACE>",
        "FORGE_SERVER_ID": "<REPLACE>",
        "FORGE_SITE_ID": "<REPLACE>"
      }
    }
  }
}

Security and usage tips

Keep your Forge API credentials secure. Do not share the generated MCP configuration with untrusted parties, and rotate keys periodically. Use environment variables to manage sensitive values in your deployment environment where possible.