Skip to main content
Glama
deenesjakoruzh
echelonlabs-sf

@runehand/mcp-server

by echelonlabs-sf
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@runehand/mcp-server

MCP server that wraps the Runehand public API v1 as tools, so an MCP client (Claude Desktop, Claude Code, etc.) can operate Runehand bots directly: list bots and flows, read and reply to conversations, manage leads, and check analytics.

Setup

  1. Generate an API key at https://app.runehand.co/settings/api-keys (requires a Pro or Enterprise plan, and the owner or admin role in the workspace). The plaintext key is shown once — copy it.

  2. Add this to your MCP client's config (example: Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "runehand": {
      "command": "npx",
      "args": ["-y", "@runehand/mcp-server"],
      "env": { "RUNEHAND_API_KEY": "rh_live_..." }
    }
  }
}

  1. Restart your MCP client. It should now list 9 Runehand tools.

Related MCP server: eduframe-mcp

Configuration

Env var

Required

Default

Purpose

RUNEHAND_API_KEY

Yes

—

Bearer token from /settings/api-keys.

RUNEHAND_API_BASE_URL

No

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

Override for local/staging testing only.

Tools

Tool

Description

list_bots

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

list_flows

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

get_flow

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

list_conversations

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

get_conversation

Get a single conversation, including its messages.

send_message

Send a message as the agent in an existing conversation.

list_leads

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

create_lead

Create a lead directly, without an associated conversation.

get_analytics

Get workspace KPIs and quick stats for a date range.

Errors from the Runehand API surface as tool errors in the form "{code}: {message}" (e.g. not_found: Not found.) — see the error codes table in the API docs.

Development

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/

License

MIT

Install Server
F
license - not found
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • server

    An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform

  • better-notion-mcp

    Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • postman-mcp-server

    A basic MCP server to operate on the Postman API.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/echelonlabs-sf/runehand-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server