CLI command

probierz mcp-call list

Every tool a product's MCP server serves, with its description and input schema.

Invocation#

Shell
probierz mcp-call list --seconds <N> (--url <ENDPOINT> | -- <PROGRAM> [ARGS...])

Required inputs and options#

  • After --, the program that serves the product's MCP on stdio and its arguments, as its documentation gives them; or --url, the product's MCP endpoint over Streamable HTTP, instead of a program. --seconds is how long the server may take to answer each request.

Output and state effects#

On stdio, starts the program, speaks the Model Context Protocol's stdio transport to it (one JSON-RPC message a line) and ends it when the answer is in; with --url, POSTs each message to the endpoint, reads the answer as JSON or from the event stream it answers with (a data: line per message, the answer among notifications), sends back the session it handed out at initialize (Mcp-Session-Id) and the protocol revision it agreed (MCP-Protocol-Version) with every later message, and ends the session with a DELETE. Either way it initializes, asks tools/list for every page by its nextCursor and prints {program, url, server, protocolVersion, tools}, each tool's name, description and inputSchema. A notification the server sends is read past; on stdio a request it sends is answered as a method this client does not serve. Every wait for an answer is announced on stderr through the shared Stado process wait.

Exact refusals#

  • program-unstartable (exit 1): the program cannot be started, naming it and the system's error.
  • server-silent (exit 1): no answer within --seconds; server-closed (exit 1): the server closed its output, or its input, before answering, with how it ended; answer-malformed (exit 1): it wrote a line that is no JSON-RPC message, which the stdio transport forbids (logs belong on standard error); server-error (exit 1): it answered with a JSON-RPC error object, printed as it came. Each names the program or endpoint and the request.
  • http-refused (exit 1): the endpoint could not be reached, answered an HTTP error (its status and the start of its body are named), or answered with no JSON-RPC response to the request. --url together with a program after --, or neither, is refused by the parser (exit 2). Real test: tests/mcpcall/calls.rs (the test product's mcp.mjs on stdio and its /mcp endpoint).

Declared refusals#

What probierz refusals list declares for this command at revision d2cd6156e8b8dc6204dab7b46ec0b34b2bb03cea (probierz 0.1.7 (revision unknown, not built from a git checkout)): each cause's id, the operation declaring it, its exit status and code, and its remedy.

  • program-unstartable (probierz.mcp-call, exit 1, config): starting the MCP server {program}: {error}. name after -- the program that serves the product's MCP on stdio and its arguments, as its documentation gives them.
  • server-silent (probierz.mcp-call, exit 1, refused): waiting for {program} to answer {method}: it answered nothing in {seconds} s. give it the time it takes with --seconds, or find in its standard error, shown above, why it does not answer.
  • server-closed (probierz.mcp-call, exit 1, refused): asking {program} {method}: {observed}. start the server by hand with the same command to see why it ends.
  • answer-malformed (probierz.mcp-call, exit 1, refused): reading what {program} answered {method}: it wrote a line that is no JSON-RPC message, which the MCP stdio transport does not allow: {line}. the server writes its logs to standard error, never to standard output.
  • server-error (probierz.mcp-call, exit 1, refused): asking {program} {method}: it answered the error {error}. read the error: an unknown tool is named by probierz mcp-call list; arguments are held to the tool's input schema.
  • http-refused (probierz.mcp-call, exit 1, refused): asking the MCP endpoint {url} {method}: {observed}. give --url the endpoint the product's documentation names for its MCP over Streamable HTTP, and check that this machine reaches it and that it answers each POSTed message with JSON or an event stream holding the response.
  • tool-failed (probierz.mcp-call, exit 1, refused): calling the tool {tool} of {program}: the tool answered isError: {text}. a journey that expects this refusal holds the answer printed; otherwise fix what the tool says.
  • arguments-invalid (probierz.mcp-call, exit 2, refused): reading the arguments of the tool {tool}: --arguments is {problem}. give --arguments a JSON object, like '{"title": "Third item"}'.

Source snapshot#

Generated from the Rust binaries at revision 99a74945a3598a8d73b6c6cbe5aae4f283becea3 of Probierz's private source repository.

Combined help SHA-256: 77529678a61237f774b59e76df0d1907cb749ef5da56d2ed913b040793b7d30b; binary SHA-256: be9e0eaff0e6ea50403a0c6f6d467697a4eac676f9523b8dc13a596d2b5526c5.