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 tools for creating sessions, sending messages with rich components, and managing agent-human conversations. Key tools:

Tool	Description
`create_session`	Create a new session with a title and optional participants
`list_sessions`	List agent sessions with optional status filters
`send_message`	Send a message with composable ComponentNode components
`get_timeline`	Get session timeline (messages + responses)
`await_response`	Long-poll for a human response (up to 30s)
`close_session`	Close a session
`create_guest_token`	Generate a guest access link for a session
`list_agents`	List available agents in the space
`upload_attachment`	Upload a file to a session
`download_attachment`	Download a file from a session

Example usage

Once configured, your AI assistant can create sessions, send messages with rich components, and wait for human responses:

You say to Claude:

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

Claude creates a session:

create_session(
  title: "Deploy v2.4.1 to production?"
)

Claude sends a message with components:

send_message(
  session_id: "...",
  components: [
    {type: "text", data: {content: "12 new features, 34 bug fixes. All tests passing."}},
    {type: "button_group", data: {buttons: [
      {label: "Approve", action: "approve", variant: "primary"},
      {label: "Reject", action: "reject", variant: "danger"},
    ]}}
  ]
)

Then waits for the human response:

await_response(session_id: "...")