All integrations

Laravel Forge

Inspect servers, sites, and deployments on Laravel Forge — read logs and trigger deploys via the Forge API.

Manual setup 15 tools

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

  1. Sign in to Laravel Forge.
  2. Go to Account → API and create an API token. Copy it somewhere safe — Forge shows it only once.
  3. Note your organization slug from the Forge URL when viewing your organization (for example forge.laravel.com/orgs/my-org → slug is my-org). Use list-organizations-tool after connecting if you are unsure.
  4. In stackgate.ai, open Integrations → Laravel Forge.
  5. 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/forge with 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-tool requires site: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.