mctop

A terminal client for MCP servers

curl and k9s, but for the Model Context Protocol: explore a server, call its tools, and gate its contract in CI.

$curl -fsSL https://mctop.org/install | sh
the client
❯ mctop uvx mcp-server-time connected

tools 2

get_current_time

convert_time

resources 0

prompts 0

get_current_time

Get the current time in a given timezone

arguments

timezone* string

❯ enter to call

enter open · / search · tab section · ? keys

Run mctop <target> with no subcommand to open the full-screen client: browse a server's tools, resources, and prompts, fill in a tool's arguments, and read the result.

commands
  • exploremctop <target>Open the interactive client
  • scriptmctop ls <target>List tools, resources, and prompts
  • mctop call <target> <tool>Call one tool and print the result
  • testmctop test <spec.yaml>Assert a contract in CI, fail on drift
  • mctop record <target>Save a session's calls as a spec
  • loginmctop login <url>Log in to an OAuth server
  • upgrademctop upgradeUpdate in place

A target is a command to spawn ("uvx mcp-server-time") or an http(s):// URL. Explore, script, and test each have a page; login and upgrade are utilities.

releasesAll releases →
⌂