Laravel Forge
Inspect servers, sites, and deployments on Laravel Forge — read logs and trigger deploys via the Forge API.
Overview
Connect Laravel Forge to let AI clients inspect your servers, sites, and deployments — and trigger deploys when needed.
Prerequisites
- A Laravel Forge account with API access
- A stackgate.ai account
Getting credentials
- Sign in to Laravel Forge.
- Go to Account → API and create an API token. Copy it somewhere safe — Forge shows it only once.
- Note your organization slug from the Forge URL when viewing your organization (for example
forge.laravel.com/orgs/my-org→ slug ismy-org). Use list-organizations-tool after connecting if you are unsure. - In stackgate.ai, open Integrations → Laravel Forge.
- Click Activate and enter your organization slug and API token.
See the Forge API documentation for token permissions and organization access.
Using with AI clients
- Dedicated endpoint:
POST /mcp/forgewith a Sanctum bearer token - Private gateway: one config for all integrations — use
forge__*namespaced tools
See Documentation for HTTP authentication and private gateway setup.
Troubleshooting
- 422 integration not configured — complete the credential form in My Integrations with both API token and organization slug.
- 401 Unauthorized — regenerate the API token in Forge and update your integration credentials.
- 403 Forbidden — your Forge role may lack permission for the action (for example
trigger-deployment-toolrequiressite:manage-deploys). - 429 Too many requests — Forge limits API calls to 60 per minute; wait and use pagination cursors instead of rapid polling.
Available tools
-
list-organizations-tool
List Laravel Forge organizations accessible to the connected API token.
-
get-current-user-tool
Get the Laravel Forge user profile for the connected API token.
-
list-servers-tool
List servers in the configured Forge organization.
-
get-server-tool
Get details for a single Forge server by ID.
-
list-sites-tool
List sites on a Forge server.
-
get-site-tool
Get details for a single site on a Forge server.
-
list-org-sites-tool
List all sites across the configured Forge organization.
-
list-deployments-tool
List deployment history for a Forge site.
-
get-deployment-tool
Get details for a single deployment on a Forge site.
-
get-deployment-log-tool
Get the output log for a Forge site deployment.
-
get-deployment-script-tool
Get the deployment script configured for a Forge site.
-
get-deployment-status-tool
Get the current deployment status for a Forge site.
-
list-server-events-tool
List recent events for a Forge server.
-
get-site-application-log-tool
Get the application log for a Forge site.
-
trigger-deployment-tool
Trigger a deployment for a Forge site (Deploy Now). Requires site:manage-deploys permission.
MCP endpoint:
https://stackgate.ai/mcp/forge
(HTTP) or via the private gateway.