MCP server
orkestr exposes an MCP (Model Context Protocol) endpoint that lets AI coding assistants manage your projects, deployments, and infrastructure as tool calls. Connect Claude Code, Claude Desktop, Cursor, Windsurf, or any MCP-compatible client and use natural language to deploy, monitor, and manage your apps.
At a glance
- Endpoint:
https://orkestr.eu/api/mcp - Transport: Streamable HTTP
- Auth: Bearer API token (mint in Settings -> API)
- Tools available: 50+ across all platform resources
Setup
Mint an API token in the console (Settings -> API), then add one of the snippets below to your MCP client config. Replace ork_your_token_here with your actual token.
Claude Code CLI - one-liner
claude mcp add --transport http orkestr https://orkestr.eu/api/mcp \
--header "Authorization: Bearer ork_your_token_here"Claude Desktop / Claude Code config
Paste into ~/.claude.json (Claude Code) or claude_desktop_config.json (Claude Desktop). Restart the client to load the new MCP.
{
"mcpServers": {
"orkestr": {
"command": "npx",
"args": [
"mcp-remote",
"https://orkestr.eu/api/mcp",
"--header",
"Authorization: Bearer ork_your_token_here"
]
}
}
}Cursor
Paste into .cursor/mcp.json at the root of your workspace. Restart Cursor.
{
"mcpServers": {
"orkestr": {
"url": "https://orkestr.eu/api/mcp",
"headers": {
"Authorization": "Bearer ork_your_token_here"
}
}
}
}Available tools
Every platform action is exposed as an MCP tool with a typed schema. Listed by category below; check your MCP client for the canonical signature.
Projects
list_projectsList all your projects.get_projectGet project details by name or ID.create_projectCreate a new project from a git repo.update_projectUpdate project settings.delete_projectDelete a project and its infrastructure.analyze_projectDetect framework, port, and resources.Environments
list_environmentsList environments for a project.create_environmentCreate a new environment.update_environmentUpdate environment settings.delete_environmentDelete a non-production environment.Deployments
deployTrigger a deployment (defaults to production).list_deploymentsList recent deployments.get_deploymentDeployment details and pipeline steps.get_deployment_logsBuild / deploy logs by step.rollback_deploymentRollback to a previous deployment (Pro+).Monitoring
get_logsApplication runtime logs (stdout / stderr).get_statsContainer CPU, memory, network stats.get_healthContainer status, uptime, restart count.get_request_metricsRPS, error rate, p50 / p95 / p99 latency.get_app_healthLive app health badge from traffic + last deploy.get_deployment_statsSuccess rate, average duration, last deploy.sleep_containerManually put a container to sleep.wake_containerWake a sleeping container.get_deployment_build_logFull builder output for a failed deploy.Functions
list_functionsList your serverless functions.get_functionFunction details (URL, runtime, status).create_functionCreate a new serverless function.update_functionUpdate code, deps, auth, env vars, idle timeout.delete_functionDestroy the function container and image.deploy_functionBuild and deploy the function.get_function_logsRecent function container logs.invoke_functionInvoke a deployed function and return the response.get_function_env_varsDecrypted env vars for a function.get_function_metricsFunction request metrics.rotate_function_api_keyRotate the function API key.Project / environment extras
get_project_env_varsDecrypted project-level env vars.get_environment_env_varsDecrypted env vars for a specific environment.get_project_webhookWebhook info: provider, URL, last delivery.toggle_project_webhookEnable or disable auto-deploy on git push.Add-ons
list_addonsList databases and caches for a project.get_addonSingle add-on with connection URL.create_addonProvision a PostgreSQL or Redis add-on.delete_addonDestroy an add-on and its data.toggle_addon_auto_backupToggle daily auto-backup on / off.get_addon_backup_infoBackup retention, daily quota, next run.Backups
list_backupsList backups for an add-on.create_backupTrigger a manual backup.download_backupGet a download URL for a backup.delete_backupDelete a backup.Domains
list_domainsList your projects with custom domain status.verify_domainRe-check that DNS points to orkestr.Registry
list_registry_imagesDocker images stored for a project.scan_registry_imageTrigger a security scan.delete_registry_imageDelete an image tag. Live tag is protected.Activity
list_activityRecent activity (audit log).get_dashboard_summaryProject count, plan usage, recent deploys.Notifications
list_notifications50 most recent notifications.mark_notifications_readMark all notifications as read.Project groups
list_groupsList your project groups (workspaces).get_groupGet a group with its assigned projects.create_groupCreate a project group.delete_groupDelete a group (projects are not deleted).add_project_to_groupAssign a project to a group.remove_project_from_groupRemove a project from a group.Auth
whoamiShow current user info and plan.Example prompts
Once connected, use natural language. The model picks the right tool, fills in the arguments from context, and you see the result.
“Deploy my-api to production”
Triggers a deployment for the my-api project.
“Show me the logs for my-api, last 50 lines”
Fetches runtime logs from the container.
“Create a staging environment for my-api on the develop branch”
Creates a new environment with auto-deploy.
“What's the CPU and memory usage of my-api?”
Returns container resource stats.
“Add a PostgreSQL database to my-api”
Provisions a managed Postgres add-on.
“List all my projects and their status”
Shows all projects with framework and status info.
“Roll back my-api to the previous deployment”
Finds the last good deployment and rolls back.