io.github.imperalcloud/imperal-mcp

Official

Imperal MCP

Build, validate, smoke-test & deploy Imperal declarative IR apps from any LLM or agent.

Build, validate, test, and deploy Imperal declarative infrastructure applications.

Install

Configuration

Environment variables

IMPERAL_API_URL

Override the Imperal API base URL (default: https://auth.imperal.io). Leave unset for production.

IMPERAL_TOKENsecret

Optional service token for CI or headless environments. When set, skips browser login. Obtain from panel.imperal.io → Developer → Access tokens.

claude_desktop_config.json

{
  "mcpServers": {
    "imperal-mcp": {
      "command": "uvx",
      "args": [
        "imperal-mcp"
      ],
      "env": {
        "IMPERAL_API_URL": "<YOUR_IMPERAL_API_URL>",
        "IMPERAL_TOKEN": "<YOUR_IMPERAL_TOKEN>"
      }
    }
  }
}