laravel-forge-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FORGE_ORG | No | Optional default organization slug. Without it, the server uses your only organization or asks. | |
| FORGE_API_TOKEN | Yes | Your Laravel Forge API token, required. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| forge_whoamiA | Pokazuje zalogowanego uzytkownika Forge oraz liste jego organizacji wraz z ich slugami. Zacznij od tego narzedzia, gdy nie wiesz, do ktorej organizacji nalezy zasob. |
| forge_list_serversA | Wypisuje serwery w organizacji: identyfikator, nazwe, adres IP, wersje PHP i gotowosc. Uzyj argumentu search, zeby zawezic liste po nazwie. |
| forge_list_sitesA | Wypisuje site w organizacji albo na wskazanym serwerze: identyfikator, domene, status i status ostatniego wdrozenia. Argument server przyjmuje nazwe serwera albo jego identyfikator. |
| forge_resolveA | Zamienia domene albo nazwe na komplet identyfikatorow {organization, server, site}. Przydatne, gdy chcesz uzyc forge_call, ktore wymaga surowych identyfikatorow. |
| forge_get_serverA | Pokazuje pelne dane serwera: adresy IP, dostawce, region, wersje PHP, typ bazy i status uslug. Argument server przyjmuje nazwe serwera albo jego identyfikator. |
| forge_server_eventsA | Pokazuje ostatnie zdarzenia serwera - to odpowiedz na pytanie "co sie teraz dzieje z serwerem". Podaj argument event, zeby zobaczyc pelne wyjscie konkretnego zdarzenia. |
| forge_restart_serviceA | Restartuje, uruchamia albo zatrzymuje usluge na serwerze: nginx, php, mysql, postgres, redis lub supervisor. Zatrzymanie uslugi jest operacja destrukcyjna i wymaga flagi --allow-destructive. |
| forge_server_actionB | Wykonuje akcje na samym serwerze, na przyklad reboot. Reboot jest operacja destrukcyjna i wymaga flagi --allow-destructive. |
| forge_get_server_logA | Pobiera zawartosc logu systemowego serwera po jego kluczu, np. "nginx-error". Logi konkretnego site pobierzesz narzedziem forge_get_site_logs. |
| forge_get_siteA | Pokazuje pelne dane site: status, wersje PHP, repozytorium, katalogi, HTTPS i status ostatniego wdrozenia. Argument site przyjmuje domene albo identyfikator. |
| forge_deploy_siteA | Uruchamia wdrozenie site. Domyslnie zwraca potwierdzenie startu bez czekania na koniec - ustaw wait na true, zeby odpytywac status az do zakonczenia (maksymalnie 2 minuty). Postep sprawdzisz tez narzedziem forge_deployment_status. |
| forge_list_deploymentsB | Wypisuje ostatnie wdrozenia site wraz ze statusem i czasami rozpoczecia oraz zakonczenia. |
| forge_get_deployment_logA | Pobiera pelne wyjscie wdrozenia. Bez argumentu deployment bierze ostatnie wdrozenie - to najczestszy przypadek przy diagnozowaniu nieudanego deploya. |
| forge_deployment_statusA | Pokazuje biezacy status wdrozenia site - czy trwa, czy sie zakonczylo i kiedy sie zaczelo. |
| forge_get_deployment_scriptB | Pobiera tresc skryptu wdrozeniowego site - komendy uruchamiane przy kazdym deployu. |
| forge_update_deployment_scriptA | Nadpisuje caly skrypt wdrozeniowy site. Najpierw pobierz obecna tresc narzedziem forge_get_deployment_script, zeby nie skasowac istniejacych komend. |
| forge_get_envA | Pobiera zawartosc pliku .env site. Uwaga: zwraca sekrety w czystej postaci, wiec nie wklejaj wyniku do publicznych miejsc. |
| forge_update_envA | Nadpisuje caly plik .env site. To operacja nadpisujaca, nie scalajaca - najpierw pobierz obecna tresc narzedziem forge_get_env i zmodyfikuj ja, inaczej skasujesz wszystkie pozostale zmienne. |
| forge_get_nginx_configA | Pobiera konfiguracje Nginx dla site - przydatne przy diagnozowaniu przekierowan i naglowkow. |
| forge_update_nginx_configA | Nadpisuje cala konfiguracje Nginx site. Bledna konfiguracja moze wylaczyc strone - najpierw pobierz obecna tresc narzedziem forge_get_nginx_config. |
| forge_get_site_logsA | Pobiera logi site: application (log aplikacji Laravel), nginx-error (bledy serwera WWW) albo nginx-access (ruch). Zwraca ostatnie linie, bo logi czyta sie od konca. |
| forge_run_commandA | Uruchamia komende powloki w katalogu site, np. "php artisan migrate --force" albo "php artisan cache:clear". Domyslnie czeka na zakonczenie i zwraca wyjscie (maksymalnie minute). Komenda wykonuje sie na produkcyjnym serwerze - sprawdz ja przed uruchomieniem. |
| forge_list_background_processesA | Wypisuje procesy w tle uruchomione na serwerze - to sa workery kolejek i inne dlugotrwale komendy (w starym Forge nazywane demonami). Podaj argument process, zeby zobaczyc jego log. Uwaga: w API v2 procesy w tle naleza do serwera, nie do pojedynczego site. |
| forge_background_process_actionA | Restartuje, uruchamia albo zatrzymuje proces w tle na serwerze - tak restartuje sie workery kolejek. Zatrzymanie jest operacja destrukcyjna i wymaga flagi --allow-destructive. |
| forge_list_scheduled_jobsA | Wypisuje zadania cykliczne (cron) serwera albo konkretnego site. Podaj argument job razem z site, zeby zobaczyc wyjscie ostatniego uruchomienia. |
| forge_list_databasesA | Wypisuje bazy danych i uzytkownikow bazy na serwerze. |
| forge_search_operationsA | Przeszukuje wszystkie 273 operacje Laravel Forge API i zwraca dopasowania wraz ze schematem parametrow. Uzyj tego, gdy potrzebna operacja nie ma wlasnego narzedzia forge_*, a potem wywolaj ja przez forge_call. Przyklady zapytan: "certificate", "firewall", "recipe", "backup". |
| forge_callB | Wykonuje dowolna z 273 operacji Laravel Forge API po jej operationId. Operacje znajdziesz narzedziem forge_search_operations. Brakujacy parametr {organization} jest uzupelniany z konfiguracji serwera. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Each tool targets a distinct resource/action: list/get/update/deploy/status are separated, and logs are explicitly scoped to server, site, or deployment. The generic forge_search_operations/forge_call pair is clearly framed as a fallback for operations without a dedicated tool, so it does not create ambiguity.
The forge_ prefix and snake_case are consistent, and most names follow verb_noun patterns like forge_list_servers, forge_get_site, and forge_update_env. A few names deviate with noun-phrase or verb-only forms such as forge_deployment_status, forge_server_events, forge_background_process_action, forge_resolve, and forge_call, so the pattern is mostly but not perfectly uniform.
28 tools is on the heavy side and above the ideal discoverability range for an MCP server. However, the Laravel Forge domain is broad and the tools are grouped by server, site, deployment, background process, and database concerns, so the set is not redundant; the generic forge_call/search pair also keeps the count from needing to grow further.
The dedicated tools cover core server, site, deployment, env, nginx, background process, scheduled job, and database workflows. Because forge_search_operations and forge_call expose all 273 Forge API operations, any missing capability such as certificates, firewall rules, recipes, or backups remains reachable without a dead end.