Documentation menu
Getting started
QuickstartAuthentication
Core concepts
Pause requestsResponse channelsTimeouts
Integrate
WebhooksMCP server
Reference
Error referenceAudit log

Docs/MCP server

PausePoint MCP Server

PausePoint ships an MCP (Model Context Protocol) server that wraps the REST API. Add it to Claude Code or any MCP-compatible agent to call PausePoint directly as a tool — no HTTP code required.

Installation#

The MCP server is a standalone Python script in mcp_server/. Install its dependencies:

bash
pip install -r mcp_server/requirements.txt

Configuration — Claude Desktop / Claude Code#

Add to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

json
{
  "mcpServers": {
    "pausepoint": {
      "command": "python",
      "args": ["/absolute/path/to/pausepoint/mcp_server/server.py"],
      "env": {
        "PAUSEPOINT_API_KEY": "pp_live_your_key_here"
      }
    }
  }
}

Or using mcp.json in your project root for Claude Code:

json
{
  "servers": {
    "pausepoint": {
      "command": "python",
      "args": ["mcp_server/server.py"],
      "env": {
        "PAUSEPOINT_API_KEY": "pp_live_your_key_here"
      }
    }
  }
}

Available Tools#

create_pause_request#

Pause your agent and ask a human for input via SMS or email. Returns a pause_id.

Parameter Type Required Description
recipient str Yes Phone number, email, or Slack webhook URL
channel str Yes "sms" | "email" | "slack"
message str Yes Question to show the human
options list[str] Yes 2–5 answer options
timeout_hours int No Default 24
timeout_default str No Option to auto-select on timeout
metadata dict No Arbitrary metadata

poll_pause_request#

Check if a human has responded to a pause request.

Parameter Type Required Description
pause_id str Yes The pause_id from create_pause_request

Returns status and response_choice when responded.

cancel_pause_request#

Cancel a pending pause. No notification is sent to the human.

Parameter Type Required Description
pause_id str Yes The pause to cancel

list_pause_requests#

List recent pause requests with optional status filter.

Parameter Type Required Description
status str No Filter: pending, responded, timed_out, cancelled
limit int No Max results (default 10)

get_audit_log#

Get the audit log of all pause events for your account.

Parameter Type Required Description
pause_id str No Filter to a specific pause
limit int No Max results (default 20)

Usage in Claude#

Once configured, you can ask Claude to pause an agent:

"Before we proceed, use PausePoint to ask the user if they want to delete these 500 records. Use their phone number +15550100."

Claude will call create_pause_request, get a pause_id, then call poll_pause_request in a loop until a response arrives.