get_routes
Answers "where is MAC/IP X", VRF/VNI contents, and hosts behind a leaf: routes of the BGP epochs bound to this graph (the latest of every source), current state by default.
Input fields:
graph_time (str): The IGP graph time, or the name of your OSPF/IS-IS
watcher (Enterprise): the snapshot alive at at (or now) is read and
named in the answer's graph_time
router_id (str, optional): Scope to one router's resolved RIB view;
omit for the whole bound epoch
vni (int, optional): EVPN L2VNI
vrf (str, optional): VRF name, resolved to its RDs across the bound
epoch's own routers
rt (str, optional): Any of the route's route targets
rd (str, optional): Route distinguisher
vtep (str, optional): EVPN originating IP or next-hop
prefix (str, optional): CIDR is an exact match; an address returns
every covering route, longest prefix first
mac (str, optional): EVPN exact match
at (str, optional): Point in time (ISO 8601) instead of current state
page (int): Page number, 1-indexed (default: 1)
per_page (int): Items per page (default: 50)
Output fields: dict with items (route rows, current state carries the winning nexthop) and pagination. An EVPN row's evpn.route_type is the EVPN route type: RT-1 Ethernet A-D, RT-2 MAC/IP, RT-3 IMET, RT-4 Ethernet Segment, RT-5 IP prefix.
Equivalent to GET /graph/{graph_time}/routes or GET /graph/{graph_time}/node/{router_id}/routes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"graph_time": "<graph_time>"
},
"name": "get_routes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| rd | No | ||
| rt | No | ||
| mac | No | ||
| vni | No | ||
| vrf | No | ||
| page | No | ||
| vtep | No | ||
| prefix | No | ||
| per_page | No | ||
| router_id | No | ||
| graph_time | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||