Imperal MCP Server

io.github.imperalcloud/imperal-mcpv0.2.3

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

Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing4mo ago

Install Imperal MCP server

claude mcp add imperal -e IMPERAL_TOKEN='<imperal-token>' -- uvx imperal-mcp

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

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

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "imperal": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "imperal-mcp"
      ],
      "env": {
        "IMPERAL_TOKEN": "<imperal-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

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

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
IMPERAL_API_URL	—	—	Override the Imperal API base URL (default: https://auth.imperal.io). Leave unset for production.
IMPERAL_TOKEN	—	yes	Optional service token for CI or headless environments. When set, skips browser login. Obtain from panel.imperal.io → Developer → Access tokens.

Freshness

Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-22 · 4mo ago · official registry · v0.2.3

FAQ

›How do I install the Imperal MCP server in Claude Code?

Run: claude mcp add imperal -e IMPERAL_TOKEN='<imperal-token>' -- uvx imperal-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Imperal require an API key?

Yes. It expects IMPERAL_TOKEN, of which 1 is a secret.

›Can I use Imperal as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Imperal in the official MCP registry?

Yes, as io.github.imperalcloud/imperal-mcp.