laravel-forge-mcp

Laravel Forge MCP server — full Forge API v2 coverage for AI assistants via the Model Context Protocol.

This server uses the official JSON:API v2 endpoints (https://forge.laravel.com/api). It does not use the legacy v1 API (/api/v1).

Features

• ~270 tools covering servers, sites, deployments, databases, backups, PHP, services, teams, roles, recipes, and more

• Cursor pagination, filtering, sorting, and relationship includes

• Automatic rate-limit retry (429 + Retry-After)

• Organization-scoped paths with optional default org via FORGE_ORGANIZATION

Requirements

• Node.js >= 20

• A Forge API token

Environment variables

FORGE_API_KEY is accepted as a silent alias for FORGE_API_TOKEN.

Install

Cursor

Add to your user config (~/.cursor/mcp.json) or project config (.cursor/mcp.json):

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

You can also add the server from Cursor Settings → Tools & MCP.

Claude Desktop

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

{
  "mcpServers": {
    "laravel-forge-mcp": {
      "command": "npx",
      "args": ["-y", "@vitrion/laravel-forge-mcp"],
      "env": {
        "FORGE_API_TOKEN": "your-forge-api-token",
        "FORGE_ORGANIZATION": "your-org-slug"
      }
    }
  }
}

Claude Code

claude mcp add laravel-forge-mcp -- npx -y @vitrion/laravel-forge-mcp

Set FORGE_API_TOKEN (and optionally FORGE_ORGANIZATION) in your shell environment or MCP host config.

Tool groups

Tools are named in kebab-case and map one-to-one to Forge API v2 operations:

List tools support shared query parameters: include, filter, sort, pageSize, and cursor.

Development

git clone https://github.com/vitrionbv/laravel-forge-mcp.git
cd laravel-forge-mcp
npm install
npm run build
npm test
npm run dev

Inspector

Debug the MCP server with the official inspector (requires a built dist/):

npm run build
npm run inspector

Or directly:

npx @modelcontextprotocol/inspector node dist/index.js

License

MIT — see LICENSE.

Repository

vitrionbv/laravel-forge-mcp