Imperal MCP

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

Connector by imperalcloud · GitHub account verified by the MCP Registry

IndexedGPL-3.0Local (stdio)

Chalk Labs

Need help deploying Imperal MCP?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/imperalcloud-imperal-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 18 read · 4 write · 3 delete
Secrets: 1 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Python package

Tools by what they do 25

Read from the source code; the running server may list different tools.

Read 18 · Look things up without changing anything.

check_syntax
checkpoint_diff
coding_context
contract_slice
get_app
graph_slice
impact_of_change
list_apps
orient
outline
read_symbol
recall_context

Show 6 more tools

repo_profile
run_read_tool
search_code
smoke_ir
token_savings
validate_ir

Write 4 · Create, change, send or run things.

checkpoint
remember_fact
save_repo_note
upload_file

Delete 3 · Delete, drop, revoke or wipe things.

checkpoint_rollback
deploy_ir
run_write_tool

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

IMPERAL_TOKEN

Other settings (environment variables or headers).

IMPERAL_API_URL

Network hosts it talks to 6

anthropic.com · found in code
astral.sh · found in code
auth.imperal.io · found in code
github.com · found in code
imperal.io · found in code
panel.imperal.io · found in code

Files it touches

Your home directory (~)
Any path the agent passes to its tools

Tools (25)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

check_syntaxCheck Syntax (Tree-sitter)read-only
Fast local tree-sitter syntax validation of a source file after editing.
checkpointShadowGit Checkpoint
Capture an instant, invisible ShadowGit snapshot of the workspace without touching the user's real .git history.
checkpoint_diffShadowGit Checkpoint Diffread-only
Show a unified diff between the current workspace state and a ShadowGit checkpoint.
checkpoint_rollbackShadowGit Checkpoint Rollbackcan change or delete data
Restore the workspace to a previous ShadowGit checkpoint (an auto-safety snapshot is taken first).
coding_contextWorkspace Coding Contextread-only
Project file tree and git status snapshot (respecting .gitignore and pruning heavy build/vendor directories).
contract_sliceContract Sliceread-only
Return exact call-site contracts (signatures, return types, raises, and caller argument shapes) for the given symbols.
deploy_irDeploy IRcan change or delete data
Deploy an app.ir.json into the caller's account (creates the app record if needed).
get_appGet Appread-only
Get one app's manifest + tools (with action_type) (PII-masked).
graph_sliceCall Graph Sliceread-only
Return definition locations, signatures, direct callers, and callees for a batch of symbols from the code graph.
impact_of_changeImpact of Changeread-only
Given symbols you plan to modify, return all downstream dependent files and caller symbols that could break.
list_appsList Appsread-only
List the caller's developer apps (PII-masked).
orientOrient on Taskread-only
One-call orientation for a task: repo profile + top ranked symbols/snippets from the live code graph. Call FIRST instead of scanning files blind.
outlineCode File Outlineread-only
Tree-sitter structural map of a source file (classes, functions, methods, major blocks with exact line ranges). Call before reading large files.
read_symbolRead Symbol or Spanread-only
Read ONE symbol (function, class, Class.method, block name) or line range ('L120-180') from a file without loading the whole file.
recall_contextRecall Cross-Surface Cloud Memoryread-only
Retrieve relevant user directives, preferences, and repository notes from Imperal Cloud Memory across Webbee, Telegram, and the Panel.

Show 10 more tools

remember_factRemember Durable User Fact / Directive
Persist a durable user fact, architectural decision, or standing directive to Imperal Cloud Memory (shared across all surfaces).
repo_profileRepository Profileread-only
Structured profile of the repository (languages, file count, key architectural hubs, test command hints) from the live code index.
run_read_toolRun Read Toolread-only
Run a READ-only tool of a deployed app (refuses write/destructive).
run_write_toolRun Write Toolcan change or delete data
Run a WRITE or DESTRUCTIVE tool of a deployed app. Money tools always go through out-of-band panel approval (never terminal consent or autopilot): re-run this tool after approving in the panel to complete. Write runs directly; destructive requires human consent (elicitation) or session autopilot; read tools are refused (use run_read_tool).
save_repo_noteSave Durable Repository Note
Save a durable repository convention or architectural note to Imperal Cloud Memory.
search_codeSearch Code Graphread-only
Hybrid AST symbol + lexical code search across the indexed repository. Prefer over grep/find.
smoke_irSmoke-test IRread-only
Run one function of an app.ir.json in an ISOLATED store and report {ok,result,trace}.
token_savingsContext Compression Telemetryread-only
Return measured characters and lines returned vs. full-file baseline in this session.
upload_fileUpload Local File
Send a file from THIS machine into Imperal and get its ids back. Read the file straight off disk -- never paste its bytes into a tool call, that is truncated long before it reaches the gateway. Returns {file_id, document_id, filename, size_bytes, status}. To then PLACE that file into any extension (a task attachment, an envelope, a post), call run_write_tool with the sink's own file argument set to {"document_id": <document_id>}: the gateway swaps the reference for the real bytes on the way in, so the file never travels through this conversation.
validate_irValidate IRread-only
Validate an app.ir.json locally (envelope + every declarative step).

Signals

Stars: 0
Forks: 0
Open issues: 0
Weekly downloads: 939
Last commit: Oct 23, 2026 (6 days ago)
Last release: Oct 26, 2026 (4 days ago)
Last package publish: Oct 23, 2026 (6 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name: io.github.imperalcloud/imperal-mcp
Version: 0.8.10
Auth: API key
Packages: pypi imperal-mcp
License: GPL-3.0
Repository: github.com/imperalcloud/imperal-mcp
First seen: Oct 24, 2026
Last checked: Oct 26, 2026
Source: Official MCP Registry github-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped: 50+; launches shipped
media placements: 500+; media placements
founders on every account: 2; founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get Imperal MCP running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Need help deploying Imperal MCP?

Call Get help

Cite this page

Imperal MCP. Agent Mart. https://agentmart.dev/connectors/imperalcloud-imperal-mcp (last updated 2026-10-26)