@pergy-ai/mcp

A voice inbox for your AI agents. This MCP server lets an agent notify a user and await their reply — so a long-running agent can ask a question, hand off, and resume on the answer.

Install

No clone needed. Add it to Claude Code (-s user = available in every project; drop it for just the current one):

claude mcp add pergy -s user -- npx -y @pergy-ai/mcp

Or wire it into any MCP client config:

{
  "mcpServers": {
    "pergy": {
      "command": "npx",
      "args": ["-y", "@pergy-ai/mcp"]
    }
  }
}

First-time pairing (link the server to your Pergy account):

npx -p @pergy-ai/mcp pergy-mcp-onboard

It talks to the hosted backend by default — no config needed. Set PERGY_BACKEND_URL=http://localhost:3000 only for local development.

Tools

• notify_user — notify the user (three standalone context tiers: short / medium / long, plus optional options — each an answerable choice that can carry a sandboxed html or image preview for visual "pick one" decisions — visuals, urgency, and parentId for a clarification). Returns a request id + thread id.
• await_reply — wait for the user's reply to a specific notification (pass its id). Scoped: will not return replies meant for other notifications. Returns reply / remind / idle.
• check_replies — catch-up sweep: returns replies you haven't consumed yet (now marked seen) plus still-pending notifications.
• poll_answer — fetch the answer to a specific request by id.
• set_task_state — report progress on a request: in_progress / completed / needs_input.

Configuration

• PERGY_BACKEND_URL — the Pergy API base (defaults to the hosted backend).

License

MIT