@runehand/mcp-server
@runehand/mcp-server
Runehand 공개 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 클라이언트를 다시 시작하세요. 이제 9개의 Runehand 도구가 나열될 것입니다.
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.
Maintenance
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