Getting StartedDeployingCustom DomainsEnvironment VariablesDatabaseAddonsEnergy & BoostsCLI ReferenceAPI ReferenceMCP Integration

MCP Integration

Deploy and manage eggs directly from AI agents via Model Context Protocol.

Claude Code Plugin

The fastest way to get started. Run these two commands in Claude Code:

/plugin marketplace add https://github.com/EscapeVelocityOperations/hatch-cli
/plugin install hatch

Restart Claude Code and all Hatch tools become available. That's it.

Authentication: run hatch login first, or set HATCH_TOKEN in your environment.

Manual setup

If you're not using Claude Code, add the Hatch MCP server to your agent configuration manually:

{
  "mcpServers": {
    "hatch": {
      "command": "hatch",
      "args": ["mcp"]
    }
  }
}

Available MCP tools

The Hatch MCP server exposes these tools for AI agents:

Platform

get_platform_info— Supported frameworks, artifact format, platform constraints
health_check— Platform health check
check_auth— Check authentication status

App lifecycle

list_apps— List all deployed apps with status and URLs
create_app— Create a new app
deploy_app— Deploy a pre-built directory (creates app if needed)
get_app_details— Detailed app info including deployment history
get_status— App running status
restart_app— Restart an app
delete_app— Delete an app

Logs

get_logs— Application logs
get_build_logs— Build logs

Environment variables

set_env— Set an environment variable
get_env— List environment variables (pass show_secrets: true to unmask)
set_env_var— Set a single env var (alias for set_env)
list_env_vars— List env vars (alias for get_env, supports show_secrets)
bulk_set_env— Set multiple env vars at once
delete_env— Delete an environment variable

Database & storage

add_database— Provision PostgreSQL
get_database_url— Get DATABASE_URL
add_storage— S3-compatible bucket

Domains

add_domain— Add custom domain
list_domains— List domains
remove_domain— Remove domain

Energy

check_energy— Account energy status
get_app_energy— Per-app energy and usage
boost_app— Boost an app with extra energy

CLI alternative

You can also deploy via the CLI using hatch deploy. See the Getting Started guide or the Ask Your Agent page for agent-optimized deployment instructions.

Hatch mascot