Quick Start

Connect to a sample server

The official server-everything is the easiest target.

mcp-tui --cmd npx --args "@modelcontextprotocol/server-everything,stdio"

This launches the TUI, auto-discovers tools, resources, and prompts, and lets you exercise them.

List tools from the CLI

Tool metadata at a glance. Names, titles, annotations and output schemas for every tool, and a confirmation before any tool that declares itself destructive.

mcp-tui --cmd npx \
  --args "@modelcontextprotocol/server-everything,stdio" \
  tool list

Call a tool

Verify an MCP tool in seconds. Connect to a server, pick a tool, fill the form mcp-tui builds from its input schema, run it, and copy the same call as a CLI command.

mcp-tui --cmd npx \
  --args "@modelcontextprotocol/server-everything,stdio" \
  tool call echo message='hello mcp'

Arguments use key=value. Strings, numbers, booleans, and JSON values are coerced from the tool’s input schema.

Connect to an HTTP or SSE server

# HTTP / Streamable HTTP
mcp-tui --transport http --url https://your-server.example/mcp tool list

# SSE
mcp-tui --transport sse --url http://localhost:5001/sse tool list

Next steps

• TUI guide — keyboard navigation and discovery
• CLI reference — every subcommand and flag
• Automation & CI — exit codes, JSON output