check_inertia_daemon_status
Check if an Inertia daemon is enabled for a specific site in your Laravel Forge account.
LABSCO SUMMARY
It reads a Forge account thoroughly and creates nothing — including the servers that its own catalogue tools exist to describe.
list_providers, list_regions, list_sizes, list_ubuntu_versions, list_static_php_versions, list_database_types and list_project_types all describe themselves as the valid choices for new server or site creation, yet nothing in this set creates one, so they function as a reference you carry elsewhere. What the server does support well is the diagnosis loop: list_deployments into get_deployment into get_deployment_output, with get_server_logs and get_site_log alongside. Weigh the credential exposure before wiring this into a shared agent — get_site_env returns a site's .env as plain text and get_composer_packages_auth returns Composer credentials, so anything holding this key can read a site's secrets.
What it is
A read-only Laravel Forge client with 35 tools covering servers and sites, daemons and deployments, databases and database users, SSL certificates, the catalogues used when planning a new server, and per-site configuration reads.
What you get
- Account and servers: get_user returns the current Forge user, list_servers enumerates the account's servers, show_server returns one in detail, and get_server_logs returns its logs.
- Sites and what runs on them: list_sites and show_site cover a server's sites, list_daemons and show_daemon cover its long-running processes, get_site_log returns a site's raw log output, and get_site_env returns the site's .env file as plain text.
- Deployments in detail: list_deployments enumerates a site's deployments, get_deployment returns one, and get_deployment_log and get_deployment_output return the log behind it.
- Laravel-specific status questions, each answered for one site: check_laravel_maintenance_status, check_laravel_scheduler_status, check_pulse_daemon_status and check_inertia_daemon_status.
- Databases: list_databases and get_database for the databases on a server, list_database_users and get_database_user for the accounts against them.
- Certificates: list_certificates and get_certificate for a site's SSL certificates.
- The catalogues behind a provisioning decision: list_providers, list_regions for a provider, list_sizes for a provider and region, list_ubuntu_versions, list_static_php_versions and list_php_versions for a specific server, list_database_types, and list_project_types.
- get_composer_packages_auth returns a site's Composer package authentication credentials.
Requirements
A Laravel Forge API key, supplied as FORGE_API_KEY.
Setup effort
Add the configuration to your client
USE CASES
01
Finding out why the last deploy failed
List the site's deployments, open the one that failed, and read its output rather than opening the Forge dashboard.
02
Checking whether a site is live or sitting in maintenance mode
Ask the maintenance and scheduler status directly, and read the site record for the rest of its state.
03
Confirming a site's configuration matches what you think it is
Read the environment file the site is actually running with, check which PHP versions the server offers, and compare against the site record.
04
Checking a certificate before it expires on you
List the SSL certificates on the site and open the one in use for its details.
05
Working out the options before provisioning a new server
Read the providers, then the regions and sizes each offers, and the OS and database versions Forge supports for a new build.
35 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_laravel_maintenance_status
Check if Laravel maintenance mode is enabled or disabled for a specific site in your Laravel Forge account.
check_laravel_scheduler_status
Check if the Laravel Scheduler is enabled or disabled for a specific site in your Laravel Forge account.
check_pulse_daemon_status
Check if a Pulse daemon is enabled for a specific site in your Laravel Forge account.
get_certificate
Gets details of a specific SSL certificate for a site.
get_composer_packages_auth
Get Composer packages authentication credentials for a specific site in your Laravel Forge account.
get_database
Get details for a specific database on a server in your Laravel Forge account.
get_database_user
Get details for a specific database user on a server in your Laravel Forge account.
get_deployment
Get details of a specific deployment.
get_deployment_log
Get the log for a specific deployment.
get_deployment_output
Get the output (log) for a specific deployment on a site in your Laravel Forge account.
get_server_logs
Get logs for a specific server in your Laravel Forge account.
get_site_env
Retrieve the environment file (.env) for a specific site in your Laravel Forge account. This returns the raw .env file content as plain text.
get_site_log
Retrieve the log output for a specific site in your Laravel Forge account. This returns the raw log as plain text.
get_user
Get the current Forge user.
list_certificates
List all SSL certificates for a specific site.
list_credentials
List all credentials in your Laravel Forge account.
list_daemons
List all daemons on a specific server in your Laravel Forge account.
list_database_types
List valid database types for new server creation (static, as per Forge documentation).
list_database_users
List all database users for a specific server in your Laravel Forge account.
list_databases
List all databases for a specific server in your Laravel Forge account.
list_deployments
List all deployments for a specific site.
list_php_versions
List all available PHP versions for a specific server in Laravel Forge.
list_project_types
Lists available project types for site creation in Laravel Forge. The 'php' type is the default.
list_providers
List all available server providers for Laravel Forge.
list_regions
List available regions for a given provider using the Forge API. Also allows custom/free-text entry.
list_servers
List all servers in your Laravel Forge account.
list_sites
List all sites on a specific server in your Laravel Forge account.
list_sizes
List available sizes for a given provider and region using the Forge API. Also allows custom/free-text entry.
list_static_php_versions
List supported PHP versions for new server creation (static, as per Forge documentation). Also allows custom/free-text entry.
list_ubuntu_versions
List supported Ubuntu versions for new server creation (static, as per Forge documentation). 24.04 is the default if not specified.
show_daemon
Show details for a specific daemon on a server in your Laravel Forge account.
show_server
Show details for a specific server in your Laravel Forge account.
show_site
Show details for a specific site on a server in your Laravel Forge account.
test_connection
BEFORE YOU INSTALL
What to know first
Tools you get
35 tools when we connected; the project documents 54. Write tools are off by default; start with --tools=readonly,write to add 19, including create_server, deploy_now and reboot_server.
Requires
- npx on PATH
- Node.js
- npm
- FORGE_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"forge-mcp": {
"command": "npx",
"args": [
"-y",
"@ranium/forge-mcp"
],
"env": {
"FORGE_API_KEY": "<YOUR_FORGE_API_KEY>"
}
}
}
}
