Release summary
Trace how two objects in your infrastructure are connected, or find everything of a given kind that a change could reach — without inspecting the schema and hand-building a deep, nested GraphQL query. Two read-only tools, find_paths and find_reachable, expose the server-side graph traversal added in Infrahub 1.10. Reading a schema also becomes more controllable, with peer-schema expansion you can turn on or off.
Trace how objects connect and what a change can reach
Instead of studying the schema and hand-building a deep, nested GraphQL query, an agent can now ask two direct questions of the graph. Both tools build on the server-side path traversal added in Infrahub 1.10.
What changed
find_pathsreturns the shortest path(s) between a source and a destination node, as ordered hops — answering "how are these two connected?". Acountof0means no path exists within the search depth.find_reachablereturns the nodes of the kinds you name that are reachable from a source node — answering "what could a change here affect?".- Both accept either a UUID or the kind-qualified HFID that
get_nodesandsearch_nodesalready return (for example,InfraDevice__atl1-edge1), and both can be bounded by depth, node kind, or relationship. - Both are read-only and return compact TOON output. Against an Infrahub server older than 1.10, they fail with a clear version message instead of an opaque error.
Expand related schemas only when you need them
When reading a schema, related peer schemas are expanded one level deep so an agent can see how kinds connect. That expansion is now optional, so you can keep schema responses lean when the extra detail is not needed.
What changed
- Peer-schema expansion is controlled by the new
INFRAHUB_MCP_SCHEMA_EXPAND_PEERSsetting, enabled by default so existing behavior is preserved. get_schemaaccepts anexpandargument to override that default for a single call.
Minor changes
Testing
- Added an opt-in integration test suite (
tests/integration/, run withpytest -m integration) that exercises the server end to end against an ephemeral Infrahub provisioned by infrahub-testcontainers. The defaultuv run pytestremains Docker-free.
Security
- Resolved Python and npm dependency security alerts.
Upgrade notes
- The graph-traversal tools require Infrahub 1.10 or later and
infrahub-sdk >= 1.22, which is now the minimum supported version. On Infrahub servers older than 1.10,find_pathsandfind_reachablereturn a clear version error; every other tool is unaffected.
Full changelog
Added
- Graph-traversal tools
find_pathsandfind_reachable, exposing the server-side path traversal added in Infrahub 1.10 (#74). INFRAHUB_MCP_SCHEMA_EXPAND_PEERSsetting and a per-callexpandargument onget_schemato control peer-schema expansion (#74).- Opt-in integration test suite backed by infrahub-testcontainers (#118).
Changed
- Raised the Infrahub SDK minimum version to
>=1.22.0(#74). - Grouped dependency and GitHub Actions updates (#136, #131).