Once connected (with or without auth), the tools, resources, and prompts command groups let you explore and exercise what the server exposes.
mcpjam tools list --url https://your-server.com/mcp --access-token $TOKEN
Returns every tool the server exposes, including names, descriptions, and input schemas.
mcpjam tools call --url https://your-server.com/mcp --access-token $TOKEN \
--tool-name search_docs \
--tool-args '{"query": "authentication"}'
Tool arguments are passed as a JSON string. The result includes the tool’s response content.
tools call supports --debug-out <path> to capture the full request/response
trace for debugging. For stdio targets, the artifact records only the
explicit env keys passed through -e/--env; inherited shell variables are
not enumerated.
For a local stdio server:
mcpjam tools list \
--command npx \
--args -y @modelcontextprotocol/server-everything \
--cwd $PWD \
-e DEBUG=1
Resources
List resources
mcpjam resources list --url https://your-server.com/mcp --access-token $TOKEN
Read a resource
mcpjam resources read --url https://your-server.com/mcp --access-token $TOKEN \
--resource-uri "file:///docs/readme.md"
List resource templates
mcpjam resources templates --url https://your-server.com/mcp --access-token $TOKEN
Prompts
List prompts
mcpjam prompts list --url https://your-server.com/mcp --access-token $TOKEN
Get a prompt
mcpjam prompts get --url https://your-server.com/mcp --access-token $TOKEN \
--prompt-name summarize \
--prompt-args '{"text": "Hello world"}'
Common patterns
Enumerate the full server surface
# One-shot: doctor already sweeps everything
mcpjam server doctor --url https://your-server.com/mcp --access-token $TOKEN
# Or individually for focused output
mcpjam tools list --url $URL --access-token $TOKEN --format json | jq '.tools[].name'
mcpjam resources list --url $URL --access-token $TOKEN --format json | jq '.resources[].uri'
mcpjam prompts list --url $URL --access-token $TOKEN --format json | jq '.prompts[].name'
# List to find the tool
mcpjam tools list --url $URL --access-token $TOKEN --format json \
| jq '.tools[] | select(.name == "search_docs")'
# Call it
mcpjam tools call --url $URL --access-token $TOKEN \
--tool-name search_docs \
--tool-args '{"query": "setup guide"}' \
--format json
No-auth servers
For servers that don’t require authentication (like mcp.excalidraw.com/mcp), simply omit the auth flags:
mcpjam tools list --url https://mcp.excalidraw.com/mcp
mcpjam tools call --url https://mcp.excalidraw.com/mcp \
--tool-name read_me
Stdio child processes inherit the parent shell environment by default. Use
-e/--env to add values or override inherited ones for local subprocesses.