Skip to content

Automation & APIs

Everything you can do in the Topolograph UI, you can do programmatically. Pick the surface that fits your workflow:

  • Python SDK

    Object-oriented REST client, an SSH-based LSDB collector (Nornir), and the topo CLI.

    Python SDK

  • MCP Server

    Expose the Topolograph API to LLM agents over the Model Context Protocol.

    MCP Server

  • AI Agent

    A natural-language assistant that answers questions about your live IGP.

    AI Agent

The REST API underneath

All of these are built on Topolograph's REST API. The full, interactive schema lives at /api/ui/ on your instance (for the hosted service, topolograph.com/api/ui).

A direct upload is as simple as:

import requests

r = requests.post(
    'https://topolograph.com/api/graph',
    auth=('youraccount@domain.com', 'your-pass'),
    json={'ospf_data': '<your LSDB text>'},
)

For anything beyond a one-off call, the Python SDK gives you a much friendlier interface over the same endpoints.

LLM-friendly by design

Topolograph's data model maps cleanly onto natural-language questions, which is why the MCP server and AI agent exist — ask "what's the path between these two IPs?" instead of crafting an API call.