Skip to content
MCP server

Impri

Approval inbox that lets an AI agent propose actions and wait for a human decision

Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally or Remotely
Version
0.1.3
Listing updated
today

About Impri

Impri is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

Impri sits between an agent and anything with real-world side effects. The agent submits a proposed refund, email, deploy or database change with a preview, and a person approves, edits or rejects it from a web inbox, Slack, Telegram, Discord, email or a phone. Impri never executes the action itself: it holds the queue and the decision, and the agent acts only on approval, using the edited version if one was made.

The design is fail-closed, so pending and expired actions never run. Decisions are appended to an audit trail that cannot be updated or deleted, and webhooks carry an HMAC-SHA256 signature, timestamp and nonce. Optional watchers can poll an RSS feed, Reddit or a web page and raise items for review automatically.

The MCP server exposes the same flow as tools, over a local npx package or a hosted endpoint at api.impri.dev that takes your API key as a Bearer token. The hosted endpoint caps how long impri_await_decision will wait at 20 seconds. You can use the cloud service or run the open-core server yourself with Docker.

Install

Run in a terminal

claude mcp add --transport http impri https://api.impri.dev/mcp

Add to Settings → Connectors → Add custom connector

https://api.impri.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "impri": {
      "url": "https://api.impri.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "impri": {
      "type": "http",
      "url": "https://api.impri.dev/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "impri": {
      "serverUrl": "https://api.impri.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "impri": {
      "type": "http",
      "url": "https://api.impri.dev/mcp"
    }
  }
}

Configuration

  • IMPRI_API_KEYImpri API key (im_...). Get one at impri.dev or from your self-hosted server's first-run logs.Required
  • IMPRI_BASE_URLBase URL of a self-hosted Impri server (e.g. http://localhost:8484). Defaults to the hosted cloud.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

impri_push_action
Submit an action to the human approval inbox and get an action_id.
impri_await_decision
Poll until the human approves, rejects or the action expires.
impri_report_result
Report whether the approved action was executed or failed.
impri_inbox_status
Check how many actions are waiting for decisions.
impri_create_watcher
Create a watcher from a hand-written specification.
impri_list_watchers
List configured watchers, optionally filtered by status.
impri_list_watcher_presets
List available watcher preset templates by category.

What it does

Push for approval
Submit an action with a preview, kind and editable fields to the inbox.
Await the decision
Poll every five seconds until approved, rejected or expired.
Report the outcome
Tell Impri whether the approved action ran, closing the audit loop.
Inbox status
See how many actions are waiting before starting a batch.
Watchers
Create and list watchers and presets that raise items from RSS, Reddit or pages.
Multi-channel review
Decide from web, Slack, Telegram, Discord, email or phone.

Good for

  • Hold refunds an AI support agent wants to issue
  • Approve outbound emails or Slack messages before sending
  • Gate deploys and infrastructure changes proposed by an agent
  • Let a coding agent run overnight and approve risky steps from a phone
  • Review destructive SQL generated by a text-to-SQL agent

Pricing

Freemium

100 free approvals a month; paid tiers not shown. Open-core and self-hostable

Prices change. Check impri.dev before you buy.

Impri FAQ

Is there a free tier?

The site offers 100 free approvals a month with no card, or you can self-host.

Can I self-host?

Yes, a Docker compose setup starts the server on port 8484 and sets the base URL via IMPRI_BASE_URL.

What does it need to run?

An Impri API key (starts with im_) in IMPRI_API_KEY.

What happens if nobody decides?

Expired actions come back as expired and never execute.

Is Impri free?

Impri has a free plan, with paid plans for more usage or features.

How do I add Impri to Claude Code?

Run this command in your terminal: claude mcp add --transport http impri https://api.impri.dev/mcp

What are the best alternatives to Impri?

The closest alternatives to Impri are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Impri

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools