Laravel Cloud MCP Server

MCP server for Laravel Cloud to manage projects, environments, deployments, and other resources.

Features

This server uses the standard Node.js/TypeScript MCP SDK and communicates with the Laravel Cloud REST API using a bearer token from the environment.

Tools are provided for:

• Projects (Laravel Cloud API applications): list, get, create, update, delete

• Environments: list, get, create, update, delete

• Deployments: list, get, create

• Database clusters: list, get, create, update, delete, list types

• Databases inside clusters: list, get, create, delete

• Caches: list, get, create, update, delete, list types

• WebSocket clusters: list, get, create, update, delete

• WebSocket applications: list, get, create, update, delete

Related MCP server: Heim MCP

Configuration

Set a Laravel Cloud API token before starting the MCP server:

export LARAVEL_CLOUD_API_TOKEN="your-token"

Optional environment variables:

• LARAVEL_CLOUD_BASE_URL or CLOUD_BASE_URL: override the Laravel Cloud base URL. Defaults to https://cloud.laravel.com.

• CLOUD_API_TOKEN: fallback token variable if LARAVEL_CLOUD_API_TOKEN is not set.

Install and run

npm install
npm run build
npm start

For local development:

npm run dev

Deploy to Cloudflare Workers

This repository also includes a Cloudflare Workers entrypoint at src/worker.ts and a wrangler.jsonc configuration. The Worker exposes the MCP Streamable HTTP endpoint at:

/mcp

Configure the Laravel Cloud API token as a Worker secret:

npx wrangler secret put LARAVEL_CLOUD_API_TOKEN

Optional Worker configuration:

• LARAVEL_CLOUD_BASE_URL or CLOUD_BASE_URL: override the Laravel Cloud base URL.

• MCP_ALLOWED_ORIGINS: comma-separated list of browser origins allowed to call /mcp. Leave empty to allow non-browser MCP clients without CORS origin matching.

Run locally as a Worker:

npm run dev:worker

Deploy:

npm run deploy

When deployed, configure remote MCP clients to use:

https://<your-worker-subdomain>.workers.dev/mcp

MCP client configuration

After building, point your MCP client at the compiled stdio server:

{
  "mcpServers": {
    "laravel-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/laravel-cloud-mcp-server/dist/stdio.js"],
      "env": {
        "LARAVEL_CLOUD_API_TOKEN": "your-token"
      }
    }
  }
}

Tool names

Projects

• projects_list

• projects_get

• projects_create

• projects_update

• projects_delete

Environments

• environments_list

• environments_get

• environments_create

• environments_update

• environments_delete

Deployments

• deployments_list

• deployments_get

• deployments_create

Databases

• database_clusters_list

• database_clusters_get

• database_clusters_create

• database_clusters_update

• database_clusters_delete

• database_types_list

• databases_list

• databases_get

• databases_create

• databases_delete

Caches

• caches_list

• caches_get

• caches_create

• caches_update

• caches_delete

• cache_types_list

WebSockets

• websocket_clusters_list

• websocket_clusters_get

• websocket_clusters_create

• websocket_clusters_update

• websocket_clusters_delete

• websocket_applications_list

• websocket_applications_get

• websocket_applications_create

• websocket_applications_update

• websocket_applications_delete

List tools accept optional pagination fields where the Laravel Cloud API supports pagination:

• page

• pageSize

• allPages

Many get/list tools also accept include, which is sent as the JSON:API include query parameter.