Deploy a repository
Requires a linked GitHub account.
Deploy https://github.com/owner/repo to Orchard. Check access with list_github_deploy_targets, deploy with deploy_from_github_url, then wait on get_deployment_rollout and give me the URL.
Connect your coding agent to Orchard, then deploy and debug from your editor or terminal.
Select a client to get its setup instructions.
Add the server:
claude mcp add --transport http orchard https://mcp.your-orchard-domain/Run /mcp in Claude Code. Sign in to Orchard and approve the connection.
To share the server with a project, add .mcp.json instead:
{
"mcpServers": {
"orchard": {
"type": "http",
"url": "https://mcp.your-orchard-domain/"
}
}
}Add the server:
codex mcp add orchard --url https://mcp.your-orchard-domain/Sign in to Orchard and approve the connection:
codex mcp login orchardAdd .cursor/mcp.json to a project, or ~/.cursor/mcp.json for every project:
{
"mcpServers": {
"orchard": {
"url": "https://mcp.your-orchard-domain/"
}
}
}Sign in to Orchard and approve the connection when Cursor asks.
Add .vscode/mcp.json to your project:
{
"servers": {
"orchard": {
"type": "http",
"url": "https://mcp.your-orchard-domain/"
}
}
}Sign in to Orchard and approve the connection when VS Code asks.
In Claude, open Settings > Connectors and select Add custom connector.
Paste the server URL:
https://mcp.your-orchard-domain/Sign in to Orchard and approve the connection.
Amp: Run this command, then sign in to Orchard and approve the connection.
amp mcp add orchard 'https://mcp.your-orchard-domain/'Clients without OAuth: Create an API token.
orchard auth token create --name ci-agent --scope deploySend the token as a bearer token.
{
"mcpServers": {
"orchard": {
"type": "http",
"url": "https://mcp.your-orchard-domain/",
"headers": {
"Authorization": "Bearer <API_TOKEN>"
}
}
}
}Replace your-orchard-domain in the examples with your domain. To get the exact URL, select Account settings > MCP from the account menu.
https://mcp.your-orchard-domain/Add parameters to the server URL. They can only lower what a connection gets.
https://mcp.your-orchard-domain/?scope=readexec_in_podhttps://mcp.your-orchard-domain/?scope=deployhttps://mcp.your-orchard-domain/?toolsets=databases,domainshttps://mcp.your-orchard-domain/compactPaste these into a connected agent. Each prompt names the tools it uses.
Requires a linked GitHub account.
Deploy https://github.com/owner/repo to Orchard. Check access with list_github_deploy_targets, deploy with deploy_from_github_url, then wait on get_deployment_rollout and give me the URL.
Read-only. Works with ?scope=read.
The api app is failing. Call diagnose_deployment, then read get_deployment_logs and get_killed_container_logs. Tell me the cause. Do not change anything.
Stores the connection string as a secret variable.
Create a Postgres database named app-db with create_database. Get its connection string with get_database_connection, then add it to the api app as a secret DATABASE_URL with add_env_vars.
Asks before it changes anything.
The latest release of the api app is failing. List recent releases with list_releases. Ask me before you run rollback_to_previous, then confirm with get_deployment_rollout.
Read-only. Works with ?scope=read.
Check whether the api app has the right CPU and memory. Use get_resource_recommendation and get_deployment_metrics. Do not change anything.
Run this before you create an ingress.
Run validate_dns for app.example.com and tell me which records to create.