← Back to home

MCP Server

Use Hiloop with Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI tool. No code required -- just configure and go.

Setup

Add the Hiloop MCP server to your client config. Requires Node.js 18+.

Claude Desktop / Cursor / etc.
{
  "mcpServers": {
    "hiloop": {
      "command": "npx",
      "args": ["hiloop-mcp"],
      "env": {
        "HILOOP_API_KEY": "hlp_your_api_key"
      }
    }
  }
}

Get your API key from Admin → Agents in the Hiloop dashboard. Optionally set HILOOP_BASE_URL to override the default (https://api.hi-loop.com).

Available tools

The MCP server exposes 10 tools that Claude / your AI can call:

Tool Description
create_interaction Create an approval, chat, review, form, notification, live session, voice call, or payment
list_interactions List interactions with optional status/type filters
get_interaction Get details of a specific interaction
await_response Long-poll for a human response (up to 30s)
cancel_interaction Cancel a pending interaction
acknowledge_interaction Mark an interaction as completed
send_message Send a chat message on an interaction
list_messages List messages on an interaction
check_quota Check your usage quota
get_transitions Get status transition history

Example usage

Once configured, your AI assistant can create interactions and wait for human responses:

You say to Claude:

"Ask my team lead if I can deploy the new auth changes to production"

Claude calls:
create_interaction(
  type: "approval",
  title: "Deploy auth changes to production?",
  priority: "high",
  deadline_minutes: 60
)
Then waits:
await_response(interaction_id: "abc-123", timeout: 30)