Topolograph MCP Server

A Model Context Protocol (MCP) server that provides access to Topolograph API for OSPF/IS-IS network analysis.

Local serverstdioPython

What is the Topolograph MCP Server?

A Model Context Protocol (MCP) server that provides access to Topolograph API for OSPF/IS-IS network analysis.

What you get

This MCP server enables AI agents to interact with Topolograph API to analyze network topologies, monitor events, and perform path calculations for OSPF and IS-IS protocols. MCP (Model Context Protocol) is essential for connecting Large Language Models (LLMs) to network infrastructure, allowing AI agents to query and analyze network data in real-time.

  • Graph Management — Retrieve and upload network graphs
  • Network Analysis — Query network information by IP, node ID, or network mask
  • Event Monitoring — Track network and adjacency events with time filtering
  • Path Calculation — Calculate shortest paths between nodes with backup path support
  • Status Monitoring — Check graph connectivity and health status
  • Node/Edge Queries — Retrieve detailed node and edge information from diagrams

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_all_graphsList available graphs with filtering options
get_graph_by_timeFetch specific graph by time
get_network_by_graph_timeQuery network information
get_graph_statusCheck graph health and connectivity
get_network_eventsRetrieve network up/down events
get_adjacency_eventsGet node/host and link events
get_events_timelineNode/host events grouped into time waves for incident narration
get_nodesQuery diagram nodes (filter by role flags: ABR/ASBR, IS-IS overload/attached)
get_edgesQuery diagram edges (include=["lsp_left_bw", "lsps", "is_te_link", "edge_key"] for MPLS TE fields)
get_shortest_pathCalculate the shortest path between two nodes (with_lsps=true to account for autoroute-enabled MPLS-TE tunnels)
get_edge_failure_reactionPredict whole-network impact if one or more links go down
upload_graphUpload new graphs to the API
get_cspf_pathConstrained-shortest-path (CSPF) feasibility check between two nodes, without creating a tunnel

Configuration

VariableDescriptionRequired
TOPOLOGRAPH_API_BASEConfiguration value read at startup.Optional
TOPOLOGRAPH_API_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • “Use Topolograph to get all graphs.”
  • “Use Topolograph to get graph by time.”
  • “Use Topolograph to get network by graph time.”

Frequently asked questions

A Model Context Protocol (MCP) server that provides access to Topolograph API for OSPF/IS-IS network analysis. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.