@runehand/mcp-server
@runehand/mcp-server
Runehand public API v1 をツールとしてラップするMCPサーバーです。MCPクライアント(Claude Desktop、Claude Code など)から Runehand ボットを直接操作できます。ボットとフローの一覧表示、会話の読み取りと返信、リードの管理、アナリティクスの確認が可能です。
セットアップ
https://app.runehand.co/settings/api-keysでAPIキーを生成します(Pro プランまたは Enterprise プランと、ワークスペース内のownerまたはadminロールが必要です)。平文のキーが一度だけ表示されるので、コピーしてください。これをMCPクライアントの設定に追加します(例: Claude Desktop の
claude_desktop_config.json):
{
"mcpServers": {
"runehand": {
"command": "npx",
"args": ["-y", "@runehand/mcp-server"],
"env": { "RUNEHAND_API_KEY": "rh_live_..." }
}
}
}MCPクライアントを再起動します。Runehand のツールが9つ表示されるはずです。
Related MCP server: eduframe-mcp
設定
環境変数 | 必須 | デフォルト | 目的 |
| はい | — |
|
| いいえ |
| ローカル/ステージングでのテスト専用の上書き。 |
ツール
ツール | 説明 |
| APIキーを所有するワークスペースに属するボットを一覧表示します。 |
| ボットの UUID を指定すると、そのボットに属するフローを一覧表示します。 |
| 実行可能な形式のノードを含む単一のフローを取得します。 |
|
|
| メッセージを含む単一の会話を取得します。 |
| 既存の会話内でエージェントとしてメッセージを送信します。 |
|
|
| 関連する会話なしで、リードを直接作成します。 |
| 指定した期間のワークスペースの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 toolscreate_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
Scored across 9 tools
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.
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.
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.
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
Build your own tools from chat: design, test and host them on a shareable MCP server URL.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceMCP server that provides tools for interacting with the Fluidattacks API-- AlicenseCqualityDmaintenanceAn MCP server that exposes Eduframe resources as tools, allowing users to manage lead records through the Eduframe API. It enables listing, creating, updating, and deleting leads using natural language commands.100MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for the Runn API, enabling resource management and reporting through natural language.-
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server that gives an LLM agent standalone-equivalent control over a Mineflayer Minecraft bot — movement, mining, crafting, inventory, combat, containers, chat, and much more — exposed as 110 strongly-typed tools across 23 groups, with full bot lifecycle management and dual (poll + push) event streaming.159 npm10MIT