MCP Servers

@runehand/mcp-server

MCP server that wraps the Runehand API v1 as tools, enabling users to operate Runehand bots directly by listing bots and flows, reading and replying to conversations, managing leads, and checking analytics.

README

@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

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.
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_..." }
    }
  }
}

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

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 below.

Errors

All error responses from /api/v1/* use the same shape:

{
  "error": {
    "code": "plan_upgrade_required",
    "message": "Your current plan does not include API access.",
    "details": {
      "required_tiers": ["pro", "enterprise"]
    }
  }
}

details is null when not applicable.

Code	HTTP	When
`unauthenticated`	401	Missing header, invalid/revoked/expired token
`workspace_inactive`	403	Workspace is frozen or subscription lapsed
`plan_upgrade_required`	403	Workspace's plan doesn't include API access
`validation_failed`	422	Request data failed validation
`not_found`	404	Resource doesn't exist or doesn't belong to the key's workspace
`rate_limited`	429	Plan's requests-per-minute limit exceeded
`server_error`	500	Unhandled internal error

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

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured