Skip to main content
Work from the connection up: confirm graph reaches the server, then that it loads the tools you expect, then that a tool returns what you expect.

​
Check the connection

graph mcp list shows each configured server and how graph reaches it:
graph mcp test connects to one server and lists its tools:

​
List the tools graph loads

graph mcp tools shows each tool graph loads from a server, after include_tools and exclude_tools, with its description:
To change that list, see Filter and override a server’s tools.

​
Call a tool directly

graph tool test calls a tool by its full name and prints the result. Pass input as JSON, as @file, on stdin, or with --input key=value:
When the server rejects the call, graph prints tool returned an error: and the server’s message:
A tool that returns an error still exits 0. Use --json and check isError in scripts.

​
When it fails

  • A missing environment variable. graph names the variable and the setting that uses it, and connects to your other servers as usual:
  • Anything else. Run with -v, or set GRAPH_LOG=debug, to see graph’s log of the connection on stderr.