Skip to main content
Glama
@runehand/mcp-server

@runehand/mcp-server

@runehand/mcp-server

Runehand public API v1 をツールとしてラップするMCPサーバーです。MCPクライアント(Claude Desktop、Claude Code など)から Runehand ボットを直接操作できます。ボットとフローの一覧表示、会話の読み取りと返信、リードの管理、アナリティクスの確認が可能です。

セットアップ

  1. https://app.runehand.co/settings/api-keys でAPIキーを生成します(Pro プランまたは Enterprise プランと、ワークスペース内の owner または admin ロールが必要です)。平文のキーが一度だけ表示されるので、コピーしてください。

  2. これをMCPクライアントの設定に追加します(例: Claude Desktop の claude_desktop_config.json):

{
  "mcpServers": {
    "runehand": {
      "command": "npx",
      "args": ["-y", "@runehand/mcp-server"],
      "env": { "RUNEHAND_API_KEY": "rh_live_..." }
    }
  }
}
  1. MCPクライアントを再起動します。Runehand のツールが9つ表示されるはずです。

Related MCP server: eduframe-mcp

設定

環境変数

必須

デフォルト

目的

RUNEHAND_API_KEY

はい

—

/settings/api-keys から取得するBearerトークン。

RUNEHAND_API_BASE_URL

いいえ

https://app.runehand.co/api/v1

ローカル/ステージングでのテスト専用の上書き。

ツール

ツール

説明

list_bots

APIキーを所有するワークスペースに属するボットを一覧表示します。

list_flows

ボットの UUID を指定すると、そのボットに属するフローを一覧表示します。

get_flow

実行可能な形式のノードを含む単一のフローを取得します。

list_conversations

bot_id や status で任意にフィルタリングされた会話を一覧表示します。

get_conversation

メッセージを含む単一の会話を取得します。

send_message

既存の会話内でエージェントとしてメッセージを送信します。

list_leads

bot_id や status で任意にフィルタリングされたリードを一覧表示します。

create_lead

関連する会話なしで、リードを直接作成します。

get_analytics

指定した期間のワークスペースのKPIとクイック統計を取得します。

Runehand API のエラーは "{code}: {message}" の形式のツールエラーとして表示されます(例: not_found: Not found.)。APIドキュメントの エラーコード表 を参照してください。

開発

npm install
npm run dev      # run directly with tsx, no build step
npm test         # vitest, mocks all HTTP via msw
npm run lint
npm run typecheck
npm run build     # compiles to dist/

ライセンス

MIT

Available Tools

9 tools
create_leadCreate leadB

Create a lead directly, without an associated conversation. Does not trigger the LeadCaptured event.

Inputs: bot_id (required), name, tags, email, +4 more.

get_analyticsGet analytics dashboardA

Get workspace KPIs and quick stats for a date range, same data as the in-app dashboard.

Inputs: to, from.

get_conversationGet conversation detailA

Get a single conversation, including its messages in chronological order.

Inputs: conversation_id (required).

get_flowGet flow detailB

Get a single flow, including its nodes in executable format.

Inputs: flow_id (required).

list_botsList botsB

List the bots that belong to the workspace that owns the API key.

Inputs: page, per_page.

list_conversationsList conversationsA

List conversations for the workspace, optionally filtered by bot_id and/or status.

Inputs: page, bot_id, status, per_page.

list_flowsList flowsC

List the flows that belong to a bot, given the bot's UUID.

Inputs: bot_id (required), page, per_page.

list_leadsList leadsB

List leads for the workspace, optionally filtered by bot_id and/or status.

Inputs: page, bot_id, status, per_page.

send_messageSend messageA

Send a message as the agent in an existing conversation. Delivers to the external channel (WhatsApp, Telegram, etc.) when the conversation is not on the web channel.

Inputs: content (required), conversation_id (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: bots, flows, conversations, analytics, messaging, and leads. The list/get pairs follow a clear resource-detail distinction, so an agent can reliably select the intended tool.

    Naming Consistency5/5

    All tools use lowercase snake_case verb_noun naming: list_*, get_*, send_message, create_lead. The pattern is consistent and predictable across the entire surface.

    Tool Count5/5

    Nine tools is well-scoped for a workspace/bot/conversation/lead management server. Each tool corresponds to a meaningful operation, and there is no redundant bloat.

    Completeness4/5

    Read/query coverage is strong across bots, flows, conversations, leads, and analytics, with messaging and lead creation included. Minor gaps exist—no lead status update, conversation creation/closure, or flow editing—but these are likely handled outside this server's read-and-engage scope.

    Related MCP Connectors

    Related MCP Servers