11---
2- title : Test MCP servers with Playground
2+ title : Test MCP servers with playground
33description :
4- Use the Playground feature to test and validate MCP servers directly in the
4+ Use the playground feature to test and validate MCP servers directly in the
55 ToolHive UI with AI model providers.
66---
77
88import useBaseUrl from ' @docusaurus/useBaseUrl' ;
99import ThemedImage from ' @theme/ThemedImage' ;
1010
11- The Playground feature in ToolHive allows you to test and validate MCP servers
11+ The playground feature in ToolHive allows you to test and validate MCP servers
1212directly within the UI, without requiring additional client setup. This
1313streamlined testing environment helps teams quickly evaluate functionality and
1414behavior before deploying MCP servers to production environments.
1515
16- <ThemedImage
17- alt = ' ToolHive Playground initial interface'
18- sources = { {
19- light: useBaseUrl (' /img/toolhive/toolhive-ui-playground-start-light.webp' ),
20- dark: useBaseUrl (' /img/toolhive/toolhive-ui-playground-start-dark.webp' ),
21- }}
22- title = ' ToolHive Playground initial interface'
23- />
24-
2516## Key capabilities
2617
2718### Instant testing of MCP servers
2819
2920Enter an AI model API key, select your MCP servers and tools, and begin testing
30- immediately—right inside the desktop app. The Playground eliminates the friction
21+ immediately—right inside the desktop app. The playground eliminates the friction
3122of setting up external AI clients just to validate that your MCP servers are
3223working correctly.
3324
@@ -40,43 +31,32 @@ how they're responding to requests.
4031
4132### Integrated ToolHive management
4233
43- The Playground includes a dedicated MCP server for ToolHive itself, allowing you
34+ The playground includes a dedicated MCP server for ToolHive itself, allowing you
4435to manage your MCP servers directly through natural language commands. You can
4536list servers, check their status, start or stop them, and perform other
4637management tasks using conversational AI.
4738
4839## Getting started
4940
50- To start using the Playground feature:
41+ To start using the playground feature:
5142
52- 1 . ** Access the Playground ** : Click the ** Playground** tab in the ToolHive UI
43+ 1 . ** Access the playground ** : Click the ** Playground** tab in the ToolHive UI
5344 navigation bar.
5445
55462 . ** Configure API keys** : Click ** Configure your API Keys** to set up access to
5647 AI model providers.
5748
58- <ThemedImage
59- alt = ' ToolHive Playground API keys configuration'
60- sources = { {
61- light: useBaseUrl (
62- ' /img/toolhive/toolhive-ui-playground-api-keys-light.webp'
63- ),
64- dark: useBaseUrl (' /img/toolhive/toolhive-ui-playground-api-keys-dark.webp' ),
65- }}
66- title = ' API keys configuration modal'
67- />
68-
6949- ** OpenAI** : Enter your OpenAI API key to use GPT models
7050- ** Anthropic** : Add your Anthropic API key for Claude models
7151- ** Google** : Configure Google AI API key for Gemini models
7252- ** xAI** : Set up xAI API key for Grok models
7353- ** OpenRouter** : Add OpenRouter API key for access to multiple model providers
7454
75553 . ** Select MCP tools** : Click the tools icon to manage which MCP servers and
76- tools are available in the Playground .
56+ tools are available in the playground .
7757
7858<ThemedImage
79- alt = ' ToolHive Playground tools management showing available MCP tools'
59+ alt = ' ToolHive playground tools management showing available MCP tools'
8060 sources = { {
8161 light: useBaseUrl (
8262 ' /img/toolhive/toolhive-ui-playground-thv-mcp-light.webp'
@@ -96,24 +76,11 @@ To start using the Playground feature:
9676 have access to all enabled MCP tools and can execute them based on your
9777 requests.
9878
99- <ThemedImage
100- alt = ' ToolHive Playground chat interface with AI model and MCP tools'
101- sources = { {
102- light: useBaseUrl (
103- ' /img/toolhive/toolhive-ui-playground-start-chat-light.webp'
104- ),
105- dark: useBaseUrl (
106- ' /img/toolhive/toolhive-ui-playground-start-chat-dark.webp'
107- ),
108- }}
109- title = ' Playground chat interface in action'
110- />
111-
112- ## Using the Playground
79+ ## Using the playground
11380
11481### Testing MCP server functionality
11582
116- The Playground is ideal for validating that your MCP servers work as expected:
83+ The playground is ideal for validating that your MCP servers work as expected:
11784
11885``` text
11986Can you list all my MCP servers and show their current status?
@@ -123,7 +90,7 @@ The AI will use the `list_servers` tool from the ToolHive MCP server to provide
12390a comprehensive overview of your server status.
12491
12592<ThemedImage
126- alt = ' ToolHive Playground showing AI response with MCP tool execution results'
93+ alt = ' ToolHive playground showing AI response with MCP tool execution results'
12794 sources = { {
12895 light: useBaseUrl (
12996 ' /img/toolhive/toolhive-ui-playground-chat-response-light.webp'
@@ -175,7 +142,7 @@ Show me the logs for the meta-mcp server
175142
176143### Validating tool responses
177144
178- The Playground shows detailed information about each tool execution:
145+ The playground shows detailed information about each tool execution:
179146
180147- ** Tool name and description** : What tool was called and its purpose
181148- ** Input parameters** : The exact parameters passed to the tool
@@ -197,7 +164,7 @@ and identify any issues with tool implementation or configuration.
197164### Server management
198165
199166- Start only the MCP servers you need for testing to improve performance
200- - Use the Playground to validate new server configurations before connecting
167+ - Use the playground to validate new server configurations before connecting
201168 them to production AI clients
202169- Test different combinations of tools to understand how they work together
203170
@@ -262,4 +229,4 @@ If tools are failing to execute:
262229- Explore [ network isolation] ( ./network-isolation.mdx ) for enhanced security
263230 when testing untrusted MCP servers
264231- Check out the [ registry] ( ./registry.mdx ) to discover new MCP servers to test
265- in the Playground
232+ in the playground
0 commit comments