Impri — Claude Code MCP server: what it does, how to install
Routes autonomous agent actions into a human approval queue so reviewers can inspect, edit, or reject side effects before execution.
claude mcp add --env IMPRI_API_KEY=<IMPRI_API_KEY> --env IMPRI_BASE_URL=<IMPRI_BASE_URL> --transport stdio mcp -- npx -y @impri/mcpWhat Impri does
Impri sets up a safety checkpoint for agentic workflows. Instead of triggering external side effects directly, an agent submits its drafted action via impri_push_action and waits on impri_await_decision. The human reviewer can approve or reject the request, or tweak specific draft fields. Once finished, impri_report_result closes the loop by logging the execution status.
Impri contains 8 tools. Beyond approval queues, it offers watcher presets to track incoming signals across RSS feeds or Reddit. You can run the server locally via Docker at http://localhost:8484 or call the remote endpoint at https://api.impri.dev/mcp. An IMPRI_API_KEY is required in all setups, and the remote HTTP endpoint caps waiting timeouts at 20 seconds.
What it helps with
- intercept risky tool invocations before they reach third-party APIs
- allow reviewers to edit agent drafts before final submission
- check queue volume to prevent reviewer overload during large jobs
- set up automated keyword triggers using pre-configured templates
Example prompts for the agent
- Check the pending approval queue in Impri before starting this batch
- Send this comment draft to Impri and wait for operator approval
- Create a watcher for new GitHub releases using the preset template
How to install Impri
1Platform CLI
claude mcp add --env IMPRI_API_KEY=<IMPRI_API_KEY> --env IMPRI_BASE_URL=<IMPRI_BASE_URL> --transport stdio mcp -- npx -y @impri/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http mcp https://api.impri.dev/mcp1Platform CLI: remote server
codex mcp add mcp --url https://api.impri.dev/mcp2Platform CLI
codex mcp add mcp --env IMPRI_API_KEY=<IMPRI_API_KEY> --env IMPRI_BASE_URL=<IMPRI_BASE_URL> -- npx -y @impri/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"url": "https://api.impri.dev/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@impri/mcp"
],
"env": {
"IMPRI_API_KEY": "<IMPRI_API_KEY>",
"IMPRI_BASE_URL": "<IMPRI_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://api.impri.dev/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@impri/mcp"
],
"env": {
"IMPRI_API_KEY": "<IMPRI_API_KEY>",
"IMPRI_BASE_URL": "<IMPRI_BASE_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp https://api.impri.dev/mcp2Platform CLI
gemini mcp add -e IMPRI_API_KEY=<IMPRI_API_KEY> -e IMPRI_BASE_URL=<IMPRI_BASE_URL> mcp npx -y @impri/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Impri
How to install Impri in Claude Code?
Run claude mcp add impri -e IMPRI_API_KEY=<IMPRI_API_KEY> -- npx -y @impri/mcp in your command line.
What does Impri do?
It intercepts agent operations with side effects until a human grants approval. Operators can accept, reject, or modify payloads directly from the inbox.
Which environment variables are required?
You must provide IMPRI_API_KEY. The IMPRI_BASE_URL variable is optional and defaults to http://localhost:8484 for self-hosted instances.
