Use MCP-UI with nanobot.ai
Let's talk about the top 3 tools for testing MCP-UI servers: Goose (free agent), Postman (debugging powerhouse), and Nanobot (full MCP-UI support with agent capabilities).
When you're building MCP (Model Context Protocol) servers with UI capabilities, having the right testing tools can make or break your development experience. While basic inspectors work for simple debugging, they fall short when you need to test the full MCP-UI experience.
Let me walk you through the three best tools I've found for testing MCP-UI, ranked from good to absolutely fantastic.
Goose: The Free Agent from Block
Cost: Free (though you probably want to use an AI API key)
MCP-UI Support: Most features (not complete)
Best For: Developers who want a free solution or prefer local models
Goose is Block's local AI agent that can connect to MCP servers (they call them "extensions"). Here's what makes it special:
- Free to use - No subscription fees
- Supports multiple AI providers - OpenAI, Anthropic, or even local models
- Good MCP-UI coverage - Handles most MCP-UI features well
- Local models support - Can work with local models (though performance varies)
To get started with Goose, you'll need either an OpenAI or Anthropic API key, though local model support means you could potentially run it completely free if your hardware can handle it.
Postman: The Debugging Powerhouse
Cost: Free with paid features
MCP-UI Support: Good (not complete)
Best For: Debugging and testing MCP servers without full agent features
Postman has added MCP support, and it's pretty impressive for debugging:
- Inspector alternative - Can replace the basic MCP inspector
- UI rendering - Actually renders MCP-UI components
- Debugging focus - Great for testing server endpoints
- Mixed pricing - Free debugging, paid agent features
The cool thing about Postman is that it can serve as a replacement for the basic MCP inspector, but with actual UI rendering capabilities.
Nanobot: The MCP-UI Champion
Cost: Requires AI API key
MCP-UI Support: Nearly complete
Best For: Full MCP-UI development and testing
This is my absolute favorite, and here's why Nanobot is special:
The Magic Architecture: MCP Server → Agent → MCP Server
Nanobot does something brilliant - it turns your MCP server into an agent, then exposes that agent as another MCP server. This architecture gives you incredible flexibility and the best MCP-UI support available.
Setting Up Nanobot for MCP-UI Development
Here's exactly how I configure Nanobot for workshop development:
-
Create a dedicated directory (I use
nanobot.ignored
to keep it out of git with my global gitignore which ignores*.ignored
) -
Configure your agent with a config file:
agents:journaler:name: Journalermodel: gpt-4.1mcpServers: EpicMeMCPmcpServers:EpicMeMCP:url: http://localhost:56000/mcp
-
Find your MCP server URL - If you're using the Epic Workshop app, the URL appears in the playground inspector
-
Set your API key and run:
OPENAI_API_KEY=sk-proj-your-key nanobot run ./config.yml
The Nanobot Experience
Once running (usually on localhost:8080
), you can interact naturally with your
MCP server and if it supports MCP-UI, you'll get the full UI experience. The UI
rendering is fantastic, and it supports nearly all MCP-UI features.
Common Development Issues and Solutions
The Vite Optimization Problem
Both in Nanobot and the basic inspector, you'll hit Vite's aggressive dependency optimization:
- First connection usually fails with "Mini flare not defined" errors
- Solution: Restart the app or refresh and try again
- For iframes: Right-click and "Reload frame"
State Corruption Issues
Sometimes switching between playground exercises messes up Nanobot's state:
- Stop Nanobot completely
- Stop the workshop app (Option+click for restart options)
- Restart both
- Create a new conversation in Nanobot
Database Reset
Nanobot creates a .db
file for conversation history. During development, you
can safely delete this file anytime to start fresh.
Which Tool Should You Choose?
Go with Nanobot if:
- You want the best MCP-UI support
- You're serious about MCP development
- You don't mind spending a few cents on API calls
Choose Goose if:
- Budget is a primary concern
- You want to experiment with local models
- You need a general-purpose agent
Pick Postman if:
- You're primarily debugging server endpoints
- You want familiar tooling
- You don't need full agent capabilities
The Cost Reality
For serious MCP development, API costs are minimal - we're talking pennies for typical testing sessions. If you're building AI-powered applications, getting comfortable with API keys is just part of the territory.
The inspector is fine for basic testing, but its limitations become apparent quickly. The UI components won't actually work because they need an agent context to function properly.
Looking Forward
The MCP-UI ecosystem is evolving rapidly. Nanobot currently offers the best experience, but all these tools are improving. The key is picking one that matches your current needs and being ready to adapt as the landscape changes.
For my MCP-UI workshop, I'm using Nanobot exclusively because of its superior MCP-UI support. But having multiple options means you can choose the tool that fits your specific workflow and budget.
Ready to level up your MCP-UI development? Pick a tool, grab an API key, and start building some seriously impressive MCP servers with UI capabilities that actually work.