{
  "agentId": "agent-payments-v2",
  "userId": "user-123",
  "action": "Transfer $4,200 to vendor account ending in 9821",
  "context": {
    "vendor": "Acme Supplies",
    "amount": 4200,
    "currency": "USD",
    "invoiceId": "INV-2024-0892",
    "accountLast4": "9821"
  },
  "urgency": "high",
  "expiresIn": 1800,
  "callbackUrl": "https://my-agent.example.com/webhooks/loopin"
}

レスポンス:

{
  "interruptId": "3f4e2a1b-...",
  "status": "pending",
  "expiresAt": "2024-04-12T14:30:00Z",
  "reviewUrl": "http://localhost:3002/review/3f4e2a1b-..."
}

GET /interrupts/:interruptId

現在のステータスと判断をポーリングします。

レスポンス (保留中):

{
  "interruptId": "3f4e2a1b-...",
  "status": "pending",
  "action": "Transfer $4,200 to vendor account ending in 9821",
  "context": { ... },
  "urgency": "high",
  "createdAt": "2024-04-12T13:00:00Z",
  "expiresAt": "2024-04-12T14:30:00Z",
  "reviewUrl": "http://localhost:3002/review/3f4e2a1b-..."
}

レスポンス (解決済み):

{
  "interruptId": "3f4e2a1b-...",
  "status": "approved",
  "decision": "approved",
  "decidedAt": "2024-04-12T13:07:22Z",
  "reason": "Invoice verified, proceed."
}

POST /interrupts/:interruptId/decide

人間の判断を送信します。

リクエスト:

{
  "decision": "approved",
  "reason": "Invoice verified, proceed.",
  "modifiedParams": { "amount": 4200 }
}

レスポンス:

{
  "interruptId": "3f4e2a1b-...",
  "status": "resolved",
  "decision": "approved",
  "decidedAt": "2024-04-12T13:07:22Z"
}

GET /interrupts/pending/:userId

ユーザーのレビューを待機しているすべての保留中の割り込みを一覧表示します。

レスポンス:

[
  {
    "interruptId": "3f4e2a1b-...",
    "action": "Transfer $4,200 to vendor...",
    "urgency": "high",
    "createdAt": "...",
    "expiresAt": "...",
    "reviewUrl": "..."
  }
]

DELETE /interrupts/:interruptId

保留中の割り込みをキャンセルします（エージェントがその判断を必要としなくなった場合）。

GET /analytics/:userId

利用統計情報。

レスポンス:

{
  "userId": "user-123",
  "totalInterrupts": 47,
  "approvalRate": 0.83,
  "avgResponseTimeMs": 142000,
  "byStatus": { "approved": 39, "rejected": 8 },
  "byUrgency": { "high": 12, "medium": 28, "low": 7 },
  "topActionTypes": [
    { "action": "Send payment", "count": 18 },
    { "action": "Delete records", "count": 9 }
  ]
}

レビューページ

すべての割り込みには、人間が読める形式のレビューURLが発行されます：

GET /review/:interruptId

これには以下の内容を表示するHTMLページがレンダリングされます：

エージェントが実行しようとしていること
すべてのコンテキストデータ（フォーマット済みJSON）
緊急度バッジ
承認 / 拒否ボタン
オプションの理由入力フィールド

このURLをリクエストのレビューが必要な相手に共有してください。デフォルトではログインは不要です。

MCPツール

LoopIn MCPサーバーは、MCP互換のAIクライアント（Claude Desktop、Cursorなど）で使用できる6つのツールすべてを公開しています：

ツール	説明
`create_interrupt`	エージェントが新しい割り込みリクエストを作成
`get_interrupt_status`	エージェントが判断をポーリング
`list_pending_interrupts`	人間がレビューが必要な項目を確認
`decide_interrupt`	人間が承認または拒否
`cancel_interrupt`	エージェントが保留中のリクエストをキャンセル
`get_interrupt_analytics`	利用統計

MCPサーバーのセットアップ (stdio)

{
  "mcpServers": {
    "loopin": {
      "command": "npx",
      "args": ["-y", "@colossal-api/loopin-mcp"],
      "env": {
        "LOOPIN_API_URL": "https://your-loopin-instance.railway.app",
        "LOOPIN_API_KEY": "your-key"
      }
    }
  }
}

エージェントの利用パターン

1. Agent reaches a decision point
   → POST /interrupts { agentId, userId, action, context, urgency }
   ← { interruptId, reviewUrl }

2. Agent saves interruptId and pauses
   → (optionally: notify human via other channels with reviewUrl)

3. Agent polls until resolved
   → GET /interrupts/:interruptId
   ← { status: "pending" }   ← keep polling
   ← { status: "approved", decision, modifiedParams }  ← resume

4. Agent resumes execution
   → use modifiedParams if provided, otherwise proceed as planned

人間の利用パターン

オプションA — レビューURL（最も簡単）

エージェントから reviewUrl を受け取る（メール、Slackなど経由）
ブラウザでURLを開く
コンテキストを確認し、承認または拒否をクリックし、必要に応じて理由を追加する
完了 — エージェントは次回のポーリングで判断を取得します

オプションB — 保留中リスト（ダッシュボード）

GET /interrupts/pending/:userId — すべてのオープンなリクエストを確認
個別の reviewUrl を開くか、直接 POST /interrupts/:id/decide を呼び出す

環境変数

変数	デフォルト	説明
`PORT`	`3002`	APIサーバーのポート
`LOOPIN_BASE_URL`	`http://localhost:3002`	レビューリンク用の公開ベースURL
`API_KEY_SECRET`	(なし)	オプション: すべてのリクエストに `X-API-Key` ヘッダーを要求

Colossal APIポートフォリオ

LoopInは、AIエージェント向けのインフラストラクチャAPIスイートである Colossal API の一部です：

SubRadar — サブスクリプションの検出とキャンセル
MeetSync — カレンダーの調整とスケジュール設定
LoopIn — ヒューマン・イン・ザ・ループの割り込みと承認

すべての製品は同じ設計哲学を共有しています。つまり、エージェントがネイティブに使用できるように、MCPサーバーラッパーを備えたシンプルなREST APIです。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

DeliverdOAuth
io.github.davidpreid
Give any AI agent a way to ask a person — for approval, a decision, an answer or a review.
Autonomous Agents Communication
1
pendnt
dev.pendnt
Human approvals, notifications, inbound webhooks, wake-ups for headless agents. Free trial: /try
Autonomous Agents Agent Orchestration App Automation
1
SiliconBridge
io.github.aataqi-boop
Human-in-the-loop API for AI agents. CAPTCHA, OTP, KYC, and approvals by real humans.
Autonomous Agents Customer Support Security
2
cQnce MCPOAuth
io.github.cqnce-app
Add human approval to AI agent workflows through cQnce authorization tools.
Agent Orchestration Security
11

Related MCP Servers

final-approval
Autonomous Agents Agent Orchestration
finalapproval
A
license
A
quality
D
maintenance
Human-in-the-loop approval gate for AI agents. Your agent calls submit_approval before any irreversible action; a human reviews on a branded page; a signed webhook fires back with the decision.
Updated 6 months ago (2026-04-19 13:44 UTC)
1
1
MIT
turn-mcp-web
Agent Orchestration Autonomous Agents
shiaho777
A
license
Not graded
quality
B
maintenance
Enables human-in-the-loop checkpoints for AI agents, allowing them to pause and wait for human input via a web UI, then seamlessly resume execution.
Updated 18 hours ago (2026-10-13 13:29 UTC)
38
MIT
@looppause/mcp
Autonomous Agents Communication
soteeabam
A
license
Not graded
quality
C
maintenance
Pauses AI agent execution and routes approval requests to humans via Slack or email, with cryptographically signed proof of the human's decision.
Updated 2 months ago (2026-08-04 21:35 UTC)
23 npm
MIT
gotoHuman MCP Server
Autonomous Agents App Automation
ampcome-mcps
A
license
Not graded
quality
D
maintenance
Enables AI agents to request human approvals with customizable forms, webhooks, and team features.
Updated a year ago (2025-07-15 07:03 UTC)
34 npm
MIT

LoopIn

なぜLoopInなのか？

エンドポイント

POST /interrupts

GET /interrupts/:interruptId

POST /interrupts/:interruptId/decide

GET /interrupts/pending/:userId

DELETE /interrupts/:interruptId

GET /analytics/:userId

レビューページ

MCPツール

MCPサーバーのセットアップ (stdio)

エージェントの利用パターン

人間の利用パターン

環境変数

Colossal APIポートフォリオ

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

final-approval

turn-mcp-web

@looppause/mcp

gotoHuman MCP Server