Skip to content

cli.md

Latest commit

 

History

History
137 lines (96 loc) · 3.3 KB

cli.md

File metadata and controls

137 lines (96 loc) · 3.3 KB

CLI Reference

pip install graph-tool-call           # core CLI
pip install graph-tool-call[mcp]      # + MCP server / proxy commands

Commands at a glance

Command Purpose
search One-liner: ingest + retrieve in one step
serve Run as MCP server
proxy Run as MCP proxy (aggregates multiple MCP backends)
ingest Build a graph from a spec and save
retrieve Search a pre-built graph
analyze Print operational analysis (duplicates, conflicts, orphans)
visualize Export graph to HTML / GraphML
info Print graph statistics
dashboard Launch interactive Dash Cytoscape UI

search — one-liner search

# Ingest + retrieve in one step
graph-tool-call search "cancel order" \
  --source https://api.example.com/openapi.json

graph-tool-call search "delete user" \
  --source ./openapi.json --scores --json

Useful for quick exploration without saving the graph.

serve — MCP server

# Single source
graph-tool-call serve --source https://api.example.com/openapi.json

# Pre-built graph
graph-tool-call serve --graph prebuilt.json

# Multiple sources
graph-tool-call serve \
  -s https://api1.com/spec.json \
  -s https://api2.com/spec.json

# Remote (SSE / streamable HTTP)
graph-tool-call serve --source api.json --transport sse --host 0.0.0.0 --port 8000
graph-tool-call serve --source api.json --transport streamable-http --port 8000

See MCP Server integration guide for client configuration.

proxy — MCP proxy

graph-tool-call proxy --config ~/backends.json
graph-tool-call proxy --config backends.json --transport sse --port 8000
graph-tool-call proxy --config backends.json --passthrough-threshold 50

See MCP Proxy integration guide for backends.json format.

ingest — build and save a graph

graph-tool-call ingest https://api.example.com/openapi.json -o graph.json
graph-tool-call ingest ./spec.yaml --embedding --organize

Flags:

  • -o, --output PATH — output graph file (JSON)
  • --embedding — enable embedding-based hybrid search
  • --organize — auto-categorize tools into ontology

retrieve — search a pre-built graph

graph-tool-call retrieve "query" -g graph.json -k 10

Flags:

  • -g, --graph PATH — pre-built graph file
  • -k, --top-k N — number of results
  • --scores — print scores
  • --json — JSON output

analyze — operational analysis

graph-tool-call analyze graph.json --duplicates --conflicts

Prints duplicate tools, conflict pairs, orphan tools, category coverage.

visualize — export to HTML / GraphML

graph-tool-call visualize graph.json -f html       # interactive HTML
graph-tool-call visualize graph.json -f graphml    # Gephi/yEd
graph-tool-call visualize graph.json -f cypher     # Neo4j

info — graph statistics

graph-tool-call info graph.json
# → ToolGraph(tools=248, nodes=251, edges=1024)

dashboard — interactive UI

graph-tool-call dashboard graph.json --port 8050

Launches the Dash Cytoscape interactive dashboard for graph inspection and retrieval testing. Requires pip install graph-tool-call[dashboard].