# Laravel Forge MCP

> Laravel Forge MCP lets you manage entire web application ecosystems directly through your AI agent's chat window. You can list all connected droplets, check internal structures, deploy site scripts safely, and query databases linked to specific domains—all without leaving the conversation.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Tags:** server-management, deployment, php, automation, database-management, web-hosting

## Description

This MCP connects your developer account to an AI agent, turning complex deployment tasks into natural conversations. Instead of jumping between a console, a dashboard, and a database client, you talk to your agent. You tell it what needs fixing or deploying, and it handles the backend work. It checks server statuses, lists connected databases for any given domain, and runs full site deployment scripts—all in one go. This is how modern development ops works: talking through complex processes instead of clicking through menus. With Vinkius, this MCP puts that entire suite of devops tools right at your fingertips, letting you act like a senior engineer without having to be one.

## Tools

### deploy_site
Runs a deployment script queue to push updates to an entire repository site.

### get_server
Pulls detailed information on one specific server droplet instance.

### get_site
Retrieves specifics for a particular website layout running on a given server.

### list_databases
Lists all active databases mounted to a Forge server instance.

### list_recipes
Retrieves available custom shell recipes within your organizational team limits.

### list_servers
Gathers the master list of every connected Forge server instance.

### list_sites
Lists all websites that are mounted to a specific server droplet.

### list_ssh_keys
Retrieves active physical access keys attached to the root server.

### list_workers
Gets the queue worker configurations that are currently running on a tracked site.

## Prompt Examples

**Prompt:** 
```
Display all the cloud server instances operating in the fleet.
```

**Response:** 
```
Here's what I observed... You have 2 droplets attached: 'Production Web' and 'Staging Loadbalancer'. Should I probe their sites?
```

**Prompt:** 
```
Deploy the pending commits directly to staging site 5210 on server 1205.
```

**Response:** 
```
Deploying package payload... Success! Forge emitted a validation flag kicking off the repository deployment routine on site 5210.
```

**Prompt:** 
```
Check the active workers running on the production server.
```

**Response:** 
```
Scanning worker processes... Found 2 active Queue workers on the Production Server handling redis payloads securely.
```

## Capabilities

### Review server infrastructure status
List all connected droplets and inspect the internal structures of your deployed sites.

### Initiate site deployments
Send a deployment script to a specific repository site, watching the output as it executes.

### Check database configurations
Query active databases associated with any connected domain cluster.

### Audit worker processes
Examine the daemon configurations and queue workers running on a tracked site.

## Use Cases

### Rolling out a major feature to staging
A developer needs to push code changes to the pre-production environment. They prompt their agent: 'Deploy the pending commits directly to site 5210 on server 1205.' The agent executes `deploy_site`, reports success, and confirms the new payload is live.

### Investigating a slow background task
The application suddenly slows down because jobs aren't processing. A lead developer asks their agent to check the queue workers using `list_workers`. The agent immediately reports finding two active Queue workers, confirming if they are handling the necessary payloads.

### Onboarding a new team member
A sysadmin needs a complete overview of the infrastructure. They ask their agent to list all connected servers using `list_servers`, which provides the master inventory, followed by listing every site on those machines via `list_sites`.

### Verifying access for an external vendor
A developer needs to confirm what physical keys are available for a new service connection. They simply ask their agent and it uses `list_ssh_keys` to retrieve the active physical access key metadata.

## Benefits

- Avoid jumping between multiple dashboards. You can check the status of all connected droplets, list websites, and view SSH keys—all from a single conversational interface using `list_servers`, `list_sites`, and `list_ssh_keys`.
- Deployment is instant. Instead of manually executing scripts, you simply tell your agent to run a deployment script via `deploy_site`. The agent handles the queue execution and tracks output automatically.
- Database management becomes conversational. You never have to guess which cluster is live; just ask your agent to list databases using `list_databases` and get the details immediately.
- Audit worker processes effortlessly. Need to know if a background job is stuck? Use `list_workers` to check queue configurations running on any tracked site, ensuring nothing drops off.
- System visibility improves dramatically. If you need deep context, your agent can pull detailed data on a specific droplet with `get_server`, or look up the specifics of an exact site layout using `get_site`.

## How It Works

The bottom line is, you treat complex infrastructure management like a simple chat command.

1. Subscribe to this MCP endpoint in your AI client.
2. Provide your core Laravel Forge API token string for authentication.
3. Ask your agent to execute the required devops tasks through natural conversation.

## Frequently Asked Questions

**Can I use Laravel Forge MCP to list all my servers?**
Yes, you can. Use the `list_servers` tool to retrieve a master inventory of every connected Forge server instance in one command.

**How do I deploy code using the Laravel Forge MCP?**
You execute deployments with the `deploy_site` tool. This runs the script queue and manages the full deployment process for your specific repository site.

**What if I need to check my database settings?**
Use `list_databases`. This tool lists all active databases that are mounted onto a specific Forge server, keeping your data sources organized and visible.

**Does Laravel Forge MCP help me find SSH keys?**
Yes. The `list_ssh_keys` tool lets you retrieve the list of all active physical access keys attached to your root server for auditing purposes.

**Can I check which workers are running on a site?**
You use the `list_workers` tool. It checks and reports on the queue worker configurations currently executing tasks on any tracked site, giving you full visibility into background jobs.