Build, validate, smoke-test & deploy Imperal declarative IR apps from any LLM or agent.
Connect Runs on your machine
claude mcp add imperal-mcp -e IMPERAL_API_URL=<IMPERAL_API_URL> -e IMPERAL_TOKEN=<IMPERAL_TOKEN> -- uvx imperal-mcp==0.9.13
{
"mcpServers": {
"imperal-mcp": {
"command": "uvx",
"args": [
"imperal-mcp==0.9.13"
],
"env": {
"IMPERAL_API_URL": "<IMPERAL_API_URL>",
"IMPERAL_TOKEN": "<IMPERAL_TOKEN>"
}
}
}
}
{
"mcpServers": {
"imperal-mcp": {
"command": "uvx",
"args": [
"imperal-mcp==0.9.13"
],
"env": {
"IMPERAL_API_URL": "<IMPERAL_API_URL>",
"IMPERAL_TOKEN": "<IMPERAL_TOKEN>"
}
}
}
}
{
"servers": {
"imperal-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"imperal-mcp==0.9.13"
],
"env": {
"IMPERAL_API_URL": "<IMPERAL_API_URL>",
"IMPERAL_TOKEN": "<IMPERAL_TOKEN>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
IMPERAL_API_URLOptional | Override the Imperal API base URL (default: https://auth.imperal.io). Leave unset for production. |
IMPERAL_TOKENOptional, secret | Optional service token for CI or headless environments. When set, skips browser login. Obtain from panel.imperal.io → Developer → Access tokens. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 8 Nov 2026 |
| Last updated | 8 Nov 2026 |
| Registry name | io.github.imperalcloud/imperal-mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
