Toolhive Cloud UI

v1.0.0Developer Toolsstable

ToolHive Cloud UI surfaces MCP servers running in your infrastructure, highlighting metadata, tool capabilities, and copy-ready endpoints for fast AI agent integrations.

aienterprise-uimcpmcp-enterprisemcp-tools
Share:
12
Stars
0
Downloads
0
Weekly
0/5

What is Toolhive Cloud UI?

Toolhive Cloud UI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to toolhive cloud ui surfaces mcp servers running in your infrastructure, highlighting metadata, tool capabilities, and copy-ready endpoints for fast ai agent integrations.

ToolHive Cloud UI surfaces MCP servers running in your infrastructure, highlighting metadata, tool capabilities, and copy-ready endpoints for fast AI agent integrations.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ToolHive Cloud UI surfaces MCP servers running in your infra

Use Cases

Surface MCP servers in your infrastructure
Fast AI agent integration with copy-ready endpoints
stacklok

Maintainer

LicenseApache-2.0
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx toolhive-cloud-ui

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Toolhive Cloud UI

ToolHive Cloud UI is a Next.js web application that provides a centralized dashboard for discovering, managing, and integrating MCP servers running in your infrastructure. It surfaces server metadata, tool capabilities, and copy-ready endpoint configurations, streamlining the process of connecting AI agents to enterprise MCP deployments. Platform and DevOps teams use it to give developers a self-service portal for finding available MCP tools without needing to know internal network topology or server configurations.

Prerequisites

  • Node.js 20+ installed
  • pnpm 10+ installed (`npm install -g pnpm`)
  • An OIDC provider (Okta, Azure AD, Auth0, or the built-in mock for development) for authentication
  • A ToolHive backend API instance (or use the included mock API for local development)
  • git to clone the repository
1

Clone the repository

Clone the ToolHive Cloud UI repository from GitHub.

git clone https://github.com/stacklok/toolhive-cloud-ui.git
cd toolhive-cloud-ui
2

Install dependencies

Install all Node.js dependencies using pnpm.

pnpm install
3

Create the local environment file

Copy the example environment file and configure it for your setup. For local development the mock OIDC and mock API are pre-configured.

cp .env.example .env.local
4

Configure production environment variables

For a real deployment, edit .env.local with your OIDC provider credentials, API endpoint, and a generated auth secret.

OIDC_ISSUER_URL=https://your-idp.example.com
OIDC_CLIENT_ID=your_client_id
OIDC_CLIENT_SECRET=your_client_secret
BETTER_AUTH_SECRET=$(openssl rand -base64 32)
BETTER_AUTH_URL=https://your-app-url.com
API_BASE_URL=https://your-toolhive-backend.example.com
# Optional AI Assistant feature:
OPENROUTER_API_KEY=your_openrouter_key
5

Start the development environment

Launch the full development stack including Next.js, the mock OIDC provider, and the mock backend API.

pnpm dev
6

Run tests and linting

Run the unit test suite and linter to verify everything is working correctly.

pnpm test
pnpm lint

Toolhive Cloud UI Examples

Client configuration

Docker Compose configuration for running ToolHive Cloud UI with a real backend and PostgreSQL database in production.

{
  "mcpServers": {
    "toolhive-cloud-ui": {
      "command": "npx",
      "args": ["toolhive-cloud-ui"],
      "env": {
        "API_BASE_URL": "https://your-toolhive-backend.example.com",
        "OIDC_ISSUER_URL": "https://your-idp.example.com",
        "OIDC_CLIENT_ID": "your_client_id",
        "OIDC_CLIENT_SECRET": "your_client_secret",
        "BETTER_AUTH_SECRET": "your_generated_secret",
        "BETTER_AUTH_URL": "https://your-app-url.com"
      }
    }
  }
}

Prompts to try

Example workflows for using the ToolHive Cloud UI to discover and integrate MCP servers.

- "Show me all MCP servers currently running in the infrastructure."
- "What tools does the 'data-pipeline' MCP server expose?"
- "Give me the copy-ready endpoint configuration for the 'search' MCP server."
- "Which MCP servers support file operations or document retrieval?"
- "List all MCP servers and their connection metadata for agent configuration."

Troubleshooting Toolhive Cloud UI

OIDC authentication fails with 'invalid client' error

Verify OIDC_CLIENT_ID and OIDC_CLIENT_SECRET match exactly what is registered in your identity provider. Confirm OIDC_ISSUER_URL points to the correct tenant/realm endpoint and that the redirect URI `<BETTER_AUTH_URL>/api/auth/callback/oidc` is registered in your IdP.

pnpm dev fails with missing dependencies or build errors

Ensure you are using Node.js 20+ (`node --version`) and pnpm 10+ (`pnpm --version`). Delete node_modules and .pnpm-store then rerun `pnpm install`. The project uses strict TypeScript; build errors usually indicate a version mismatch.

API calls return 401 or the dashboard shows no servers

Check that API_BASE_URL is correctly set and the backend is reachable. In local development, ensure the mock API is running (it starts automatically with `pnpm dev`). For production, verify TRUSTED_ORIGINS includes your frontend domain.

Frequently Asked Questions about Toolhive Cloud UI

What is Toolhive Cloud UI?

Toolhive Cloud UI is a Model Context Protocol (MCP) server that toolhive cloud ui surfaces mcp servers running in your infrastructure, highlighting metadata, tool capabilities, and copy-ready endpoints for fast ai agent integrations. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Toolhive Cloud UI?

Follow the installation instructions on the Toolhive Cloud UI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Toolhive Cloud UI?

Toolhive Cloud UI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Toolhive Cloud UI free to use?

Yes, Toolhive Cloud UI is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "toolhive-cloud-ui": { "command": "npx", "args": ["-y", "toolhive-cloud-ui"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Toolhive Cloud UI?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides