# fortrabbit for coding agents

Source: https://www.fortrabbit.com/agents
Published: 2026-10-26
Updated: 2026-11-14

> Steps for a coding agent to connect to fortrabbit, leave the sign-in to the person, and host, deploy and debug PHP apps.


This page is for a coding agent. The person you work for wants to host a PHP app on fortrabbit, or already does. Follow the steps in order and skip any step that is done.

fortrabbit is managed PHP cloud hosting for Laravel, Craft CMS, Statamic, Kirby, WordPress, Symfony and plain PHP. People use the dashboard, agents use the MCP server, the `frbit` CLI and SSH.

## 1. Connect

If the `fortrabbit` MCP tools are available, `get_you` among them, go to step 3.

Otherwise tell the person what you are about to install and why, and wait for a yes. With a shell:



```shell
curl -fsSL https://www.fortrabbit.com/agents.sh | sh
```

It installs `frbit` to `~/.local/bin`, registers the MCP server and the fortrabbit skill with Claude Code and Codex, and ends with `frbit doctor`. Add `~/.local/bin` to the PATH if the shell cannot find `frbit`, and restart the session if the client asks for it. For GitHub Copilot, add `frbit skills install --agent copilot`. Homebrew and npm: [CLI docs](https://docs.fortrabbit.com/platform/automation/cli).

Other MCP clients connect to `https://mcp.fortrabbit.com/mcp` (streamable HTTP, OAuth): [MCP docs](https://docs.fortrabbit.com/platform/automation/mcp). In claude.ai or Claude Desktop, ask the person to add that URL as a custom connector under Settings → Connectors, then to start a new chat.

## 2. Leave the sign-in to the person

The first MCP call opens a browser page. Tell the person it is their step: sign up or sign in with GitHub, Google, GitLab or an e-mail address, verify the address, approve the connection.

The CLI signs in on its own. Run `frbit auth login --json` in the background, with `--signup` when the person has no account, and show them the URL and code it prints. Continue with `next` from its last line.

Never ask for an e-mail address, a password, a token or payment details in the chat.

## 3. Check the account

Call `get_you` and follow `next` (`{step, instruction, url}`) until `step` is `ready`. For `connect_git` and `add_payment_method`, give the person `next.instruction` and `next.url`. After each browser step, call `get_you` again instead of waiting for a "done". `client: true` marks a client account, which cannot create environments, deploy or restart.

## 4. How it fits together

- An **app** (`ap-xxxxxx`) is one project with one or more environments.
- An **environment** (`en-xxxxxx`) deploys one branch of a GitHub repository. Its main domain is usually `https://<label>.frbit.cloud`. SSH: `<env>@ssh.<region>.frbit.app`. Database name and user are the environment ID.
- **Components** are billed by the day: PHP, MySQL, storage, jobs. Sizes and prices come from `list_component_plans`.
- A **deployment** (`dp-xxxxxx`) starts on every push to the connected branch.

Never guess an ID, a region, a size or a software version. Look it up with a `list_*` tool or the CLI.

## 5. Core operations

| Task | MCP tool | frbit CLI |
| -- | -- | -- |
| Find the environment of this repository | `list_git_repositories`, `list_environments` | `frbit link` |
| Create an app or an environment | `detect_repository_stack`, `create_app`, `create_environment` | `frbit apps create`, `frbit environments create` |
| Environment variables | `get_environment`, `update_environment` | `frbit environments variables` |
| Deploy, restart | `create_deployment`, `restart_environment` | `frbit environments deploy` or `restart`, or `git push` |
| Why a deployment failed | `get_deployment_logs` | `frbit deployments logs` |
| Debug a slow or failing site | `get_environment_metrics`, `get_environment_logs` | `frbit environments metrics` or `logs` |
| Domains, jobs, backups | `create_domain`, `create_job`, `create_backup` and their `list_*` | `frbit domains`, `frbit jobs`, `frbit backups` |
| Database, files, remote commands | | `frbit db`, `frbit files`, `frbit ssh -- <command>` |

Add `--json` to CLI calls and run `frbit <group> --help` rather than guessing a subcommand. When a `frbit` command fails, run `frbit doctor --json` first.

## 6. Ask before

Show the exact call or command and wait for a yes before:

- creating anything billed: name, region, software, components and monthly price first
- writing environment variables
- deploying, restarting or changing anything on production
- a database or file push or pull
- deleting anything: say what will be lost, then wait for a clear yes in the person's next message

## 7. Close

Tell the person:

- the live URL: the main domain from `list_domains` (`isMain`)
- the dashboard link: `https://dash.fortrabbit.com/environments/<env>`
- the end of the free trial, when `get_app` reports one, and that a payment method keeps the app online after it: `https://dash.fortrabbit.com/new/payment-method`

## 8. Remove the setup

When the person asks to remove fortrabbit from the agent, remove the local setup only. Apps, environments and the account stay.

Run `frbit uninstall`, show the list it prints and wait for a yes, then run it again with `--yes`. Without the CLI: `claude mcp remove fortrabbit` or `codex mcp remove fortrabbit`, then delete the `fortrabbit` folder under `~/.claude/skills` or `~/.agents/skills`. Older CLI versions and the Claude Code plugin: [remove the agent setup](https://docs.fortrabbit.com/platform/automation/uninstall).

Then tell the person to revoke the connection under Connected apps: `https://dash.fortrabbit.com/you/connected-apps`.

## 9. Reference

- [www llms.txt](https://www.fortrabbit.com/llms.txt) and [docs llms.txt](https://docs.fortrabbit.com/llms.txt). Every docs page is Markdown under `/raw/<path>.md`.
- [Automation docs](https://docs.fortrabbit.com/platform/automation): MCP server, CLI, public API, agent skills, credentials
- [Agent skills index](https://docs.fortrabbit.com/.well-known/agent-skills/index.json) and [source](https://github.com/fortrabbit/agent-skills)
- [Public API reference](https://api.fortrabbit.com/v1/docs)
- [Status page](https://fortrabbit.betteruptime.com)
