Skip to content
Back to search

toolhive

ToolHive is an enterprise-grade platform for running and managing Model Context Protocol (MCP) servers.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/stacklok/toolhive with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/stacklok/toolhive'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stacklok--toolhive/badge.svg)](/listings/stacklok--toolhive)

HTML

<a href="/listings/stacklok--toolhive"><img src="/api/listings/stacklok--toolhive/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 221 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <picture>
  2. <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-byline-white.svg">
  3. <img src="docs/images/toolhive-byline-black.svg" alt="ToolHive logo" width="500"/>
  4. </picture>
  5. <br>
  6. # The open source MCP platform trusted by developers and enterprises
  7. [![Release][release-img]][release] [![Build status][ci-img]][ci]
  8. [![Coverage Status][coveralls-img]][coveralls]
  9. [![License: Apache 2.0][license-img]][license]
  10. [![Star on GitHub][stars-img]][stars] [![Discord][discord-img]][discord]
  11. ## Run any MCP server securely, instantly, anywhere.
  12. ToolHive runs every MCP server in an isolated container, enforces identity and access policy per request when configured with an authentication source, and gives platform teams the observability they need to put MCP in production.
  13. ## Why ToolHive?
  14. Here are some of the more common use cases for ToolHive:
  15. <table>
  16. <tr valign="top">
  17. <td><strong>Developers.</strong> Run MCP servers with more security and more (token) savings</td>
  18. <td><strong>Platform Engineers.</strong> Run MCP on your existing Kubernetes infrastructure</td>
  19. <td><strong>Enterprises.</strong> Self-host MCP servers and stay in control of your data</td>
  20. </tr>
  21. <tr valign="top">
  22. <td>Connect Claude Code, Cursor, GitHub Copilot, or your preferred client to MCP servers with a single click or command.<br><br>
  23. ToolHive wraps every MCP server in an isolated container with a minimal permission file (no local credentials) and uses semantic tool search to reduce your token usage by up to 85%.</td>
  24. <td>Put an end to shadow MCP use by your developers, and give your security team the audit logs and configurable identity enforcement they require.<br><br>
  25. ToolHive includes a Kubernetes operator, so you can declare policies, integrate with your IdP and observability stack, emit OTel traces, and more … all with familiar tools and patterns.</td>
  26. <td>Most MCP solutions are SaaS, but your compliance requirements prohibit sensitive info from being processed by SaaS providers.<br><br>
  27. ToolHive is the exception that allows you to self-host your MCP registry, gateway, etc. You can pilot the entire platform, and when you’re ready to scale, Stacklok’s got the added capabilities and expert team ready!</td>
  28. </tr>
  29. <tr valign="top">
  30. <td><a href="https://stacklok.com/download/">Download ToolHive and get started</a></td>
  31. <td><a href="https://docs.stacklok.com/toolhive/guides-k8s/">Explore the Kubernetes operator in our docs</a><br><br><a href="https://stacklok.com/resources/how-to-run-ai-agents-on-kubernetes">Read more about running MCP on Kubernetes</a></td>
  32. <td><a href="https://stacklok.com/platform/">Learn more about Stacklok’s platform</a><br><br><a href="https://docs.stacklok.com/toolhive/enterprise">Compare open source ToolHive and Stacklok Enterprise</a></td>
  33. </tr>
  34. </table>
  35. <picture>
  36. <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-diagram-dark.svg">
  37. <img src="docs/images/toolhive-diagram-light.svg" alt="ToolHive diagram" width="800" style="padding: 20px 0" />
  38. </picture>
  39. ## Quick links
  40. - 📥 [Downloads](https://stacklok.com/download/)
  41. - 📚 [Documentation](https://docs.stacklok.com/toolhive/)
  42. - 🚀 Quickstart guides:
  43. - [Desktop app](https://docs.stacklok.com/toolhive/guides-ui/quickstart)
  44. - [CLI](https://docs.stacklok.com/toolhive/guides-cli/quickstart)
  45. - [Kubernetes Operator](https://docs.stacklok.com/toolhive/guides-k8s/quickstart)
  46. - 💬 [Discord](https://discord.gg/stacklok)
  47. - 🤝 [Contributing](#contributing)
  48. - <img src="docs/images/stacklok-favicon.svg" width="20" height="20" style="vertical-align: middle" /> [Stacklok Enterprise](https://docs.stacklok.com/toolhive/enterprise)
  49. ---
  50. ## Core capabilities
  51. **ToolHive architecture: Gateway, Registry Server, and Runtime, accessible through ToolHive UI and the CLI**
  52. ToolHive is built on a [modular architecture](./docs/arch/README.md) to streamline secure MCP server management and integration. Here's how the main components work.
  53. ### 🔌 Gateway
  54. Define dedicated endpoints from which your teams can securely and efficiently access tools.
  55. - Orchestrate multiple tools into a virtual MCP with a deterministic workflow engine
  56. - Define access policies and network endpoints
  57. - Centralize control of security policy, authentication, authorization, auditing, etc.
  58. - Integrate with your IdP for SSO (OIDC/OAuth compatible)
  59. - Customize and filter tools and descriptions to improve performance and reduce token usage
  60. - Connect with local clients like Claude Desktop, Cursor, VS Code, and VS Code Server
  61. ### 📦 [Registry Server](https://github.com/stacklok/toolhive-registry-server)
  62. Curate a catalog of trusted servers your teams can quickly discover and deploy.
  63. - Integrate with the official MCP registry
  64. - Add custom MCP servers
  65. - Group servers based on role or use case
  66. - Manage your registry with an API-driven interface (or embed in existing workflows for seamless integration and governance)
  67. - Verify provenance and sign servers with built-in security controls
  68. - Preset configurations and permissions for a frictionless user experience
  69. ### ⚙️ Runtime
  70. Deploy, run, and manage MCP servers locally or in a Kubernetes cluster with security guardrails.
  71. - Deploy MCP servers in the cloud via Kubernetes for enterprise scalability
  72. - Run MCP servers locally via Docker or Podman
  73. - Proxy remote MCP servers securely for unified management
  74. - Kubernetes Operator for fleet and resource management
  75. - Leverage OpenTelemetry and Prometheus for monitoring and audit logging
  76. ### 💻 Interfaces
  77. Choose the interface that best fits your workflow.
  78. - Use [ToolHive UI](https://github.com/stacklok/toolhive-studio) for a cross-platform desktop experience
  79. - Use the [ToolHive CLI](https://docs.stacklok.com/toolhive/guides-cli/quickstart) for terminal workflows and automation
  80. - Discover, configure, and run MCP servers
  81. - Automatically connect managed MCP servers to compatible AI clients
  82. ### How it works together
  83. 1. **Admins** curate and organize MCP servers in the **Registry**, configuring access and policies.
  84. 2. **Users** discover, configure, and run MCP servers through **ToolHive UI** or the **CLI**, and ToolHive orchestrates deployment and access.
  85. 3. **Runtime** securely deploys and manages MCP servers across local and cloud environments, integrating seamlessly with existing SDLC workflows, exporting analytics, and enforcing fine-grained access control.
  86. 4. **Gateway** handles all inbound traffic, secures context and credentials, optimizes tool selection, and applies organizational policies.
  87. ---
  88. ## Flexible deployment
  89. ### Desktop experience
  90. Individual developers can get started in minutes with the desktop UI or CLI, then apply the same concepts in enterprise environments.
  91. **Key features:**
  92. - Run any MCP server from a container image, or build one dynamically from common package managers
  93. - Manage encrypted secrets and control network isolation with simple, local tooling
  94. - Test and validate MCP servers using built-in tools like the official MCP Inspector
  95. - Optimize token usage and tool execution with the MCP Optimizer
  96. **Get started with the UI:** [Quickstart](https://docs.stacklok.com/toolhive/guides-ui/quickstart), [How-to guides](https://docs.stacklok.com/toolhive/guides-ui/)
  97. **Get started with the CLI:** [Quickstart](https://docs.stacklok.com/toolhive/guides-cli/quickstart), [How-to guides](https://docs.stacklok.com/toolhive/guides-cli/), [Command reference](https://docs.stacklok.com/toolhive/reference/cli/thv)
  98. [**MCP guides**](https://docs.stacklok.com/toolhive/guides-mcp): learn how to run common MCP servers with ToolHive
  99. ### Kubernetes Operator
  100. Teams and organizations manage MCP servers and registries centrally using familiar Kubernetes workflows.
  101. **Key features:**
  102. - Custom Resource Definitions for MCP servers, registries, and other ToolHive components
  103. - Secure execution with container-based isolation and multi-namespace support
  104. - Automated service creation and discovery, with ingress integration for secure access
  105. - Enterprise-grade security and observability: OIDC/OAuth SSO, secure token exchange, audit logging, OpenTelemetry, and Prometheus metrics
  106. - Hybrid registry server: curate from upstream registries, dynamically register local MCP servers, or proxy trusted remote services
  107. **Get started:** [Quickstart](https://docs.stacklok.com/toolhive/guides-k8s/quickstart), [How-to guides](https://docs.stacklok.com/toolhive/guides-k8s/), [CRD reference](https://docs.stacklok.com/toolhive/reference/crd-spec), [Example manifests](./examples/operator/)
  108. ### Hybrid
  109. ToolHive's complete solution for teams and enterprises supports MCP servers across all environments: on developer machines, inside your Kubernetes clusters, or hosted externally by trusted SaaS providers.
  110. End users and developers manage approved MCP servers through ToolHive UI or the CLI, from guided desktop workflows to terminal-based automation and testing.
  111. Enterprise teams can also leverage ToolHive to integrate MCP servers into custom internal tools, agentic workflows, or chat-based interfaces, using the same runtime and access controls.
  112. <picture>
  113. <source media="(prefers-color-scheme: dark)" srcset="docs/images/toolhive-platform-dark.svg">
  114. <img src="docs/images/toolhive-platform-light.svg" alt="ToolHive platform diagram" width="800" style="padding: 20px 0" />
  115. </picture>
  116. ---
  117. ## Contributing
  118. We welcome contributions and feedback from the community!
  119. - 🐛 [Report issues](https://github.com/stacklok/toolhive/issues)
  120. - 💬 [Join our Discord](https://discord.gg/stacklok)
  121. If you have ideas, suggestions, or want to get involved, check out our contributing guide or open an issue. Join us in making ToolHive even better!
  122. <table><tr><td>
  123. Contribute to the CLI, API, and Kubernetes Operator (this repo):
  124. - 🤝 [Contributing guide](./CONTRIBUTING.md)
  125. - 📖 [Developer guides](./docs/README.md)
  126. - 📐 [Architecture documentation](./docs/arch/README.md)
  127. Contribute to the UI, registry, and docs:
  128. - 💻 [Desktop UI repository](https://github.com/stacklok/toolhive-studio)
  129. - 📦 [ToolHive registry server repository](https://github.com/stacklok/toolhive-registry-server)
  130. - 🛠️ [ToolHive's built-in registry](https://github.com/stacklok/toolhive-catalog)
  131. - 📚 [Documentation repository](https://github.com/stacklok/docs-website)
  132. </td>
  133. <td>
  134. <picture>
  135. <img src="docs/images/toolhive-mascot.png" alt="ToolHive mascot" width="250" align="middle"/>
  136. </picture>
  137. </td></tr></table>
  138. ---
  139. ## License
  140. This project is licensed under the [Apache 2.0 License](./LICENSE).
  141. <!-- Badge links -->
  142. <!-- prettier-ignore-start -->
  143. [release-img]: https://img.shields.io/github/v/release/stacklok/toolhive?style=flat&label=Latest%20version
  144. [release]: https://github.com/stacklok/toolhive/releases/latest
  145. [ci-img]: https://img.shields.io/github/actions/workflow/status/stacklok/toolhive/run-on-main.yml?style=flat&logo=github&label=Build
  146. [ci]: https://github.com/stacklok/toolhive/actions/workflows/run-on-main.yml
  147. [coveralls-img]: https://coveralls.io/repos/github/stacklok/toolhive/badge.svg?branch=main
  148. [coveralls]: https://coveralls.io/github/stacklok/toolhive?branch=main
  149. [license-img]: https://img.shields.io/badge/License-Apache2.0-blue.svg?style=flat
  150. [license]: https://opensource.org/licenses/Apache-2.0
  151. [stars-img]: https://img.shields.io/github/stars/stacklok/toolhive.svg?style=flat&logo=github&label=Stars
  152. [stars]: https://github.com/stacklok/toolhive
  153. [discord-img]: https://img.shields.io/discord/1184987096302239844?style=flat&logo=discord&logoColor=white&label=Discord
  154. [discord]: https://discord.gg/stacklok
  155. <!-- prettier-ignore-end -->
  156. <!-- markdownlint-disable-file first-line-heading no-inline-html no-emphasis-as-heading -->

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.