search_bgp_routes
Search BGP routes, one row per distinct RFC 4271 9.1 path.
Description: Without router_id, searches the whole BGP graph's route table (GET /routes). With router_id, scopes the search to that speaker's own resolved RIB view (GET /node/{router_id}/routes) -- the routes that speaker actually holds, folded on the same path definition; that scoped form does not accept bmp_source or table_filters (rib_view is already a single table). bmp_source and bmp_ribs come back as arrays.
Input fields: bgp_graph_time (str): The BGP graph epoch to query router_id (str, optional): Scope the search to one speaker's resolved RIB view prefix (str, optional): CIDR is an exact match; an address returns every covering route, longest prefix first vrf (str, optional), rd (str, optional), rt (str, optional): VPN identifiers afi (int, optional), safi (int, optional): Address family filters bmp_rib (str, optional): Filter by RIB tag (e.g. adj-rib-in-pre, loc-rib) evidence (str, optional): pre_policy, post_policy, loc_rib, or fib as_path_contains (str, optional): Substring match over the AS path origin (str, optional), local_pref (int, optional), med (int, optional) community (str, optional), large_community (str, optional), extended_community (str, optional) label (int, optional), originator_id (str, optional), peer_ip (str, optional), nexthop (str, optional) bmp_source (str, optional): Ignored when router_id is set table_filters (str, optional): URL-encoded JSON object keyed by route column, e.g. '{"communities":{"conditions":[{"join":"and","operator":"contains","value":"65000:100"}]}}'. Ignored when router_id is set. ribs (str, optional): Comma-separated exact RIB-tag set to match against the folded policy set, e.g. "loc-rib,post" sort (str, optional): Indexed route column to order by order (str): asc or desc (default: asc) page (int): Page number, 1-indexed (default: 1) per_page (int): Items per page (default: 50)
Equivalent to GET /bgp-graph/{bgp_graph_time}/routes or GET /bgp-graph/{bgp_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": {
"bgp_graph_time": "<bgp_graph_time>"
},
"name": "search_bgp_routes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rd | No | ||
| rt | No | ||
| afi | No | ||
| med | No | ||
| vrf | No | ||
| page | No | ||
| ribs | No | ||
| safi | No | ||
| sort | No | ||
| label | No | ||
| order | No | asc | |
| origin | No | ||
| prefix | No | ||
| bmp_rib | No | ||
| nexthop | No | ||
| peer_ip | No | ||
| evidence | No | ||
| per_page | No | ||
| community | No | ||
| router_id | No | ||
| bmp_source | No | ||
| local_pref | No | ||
| originator_id | No | ||
| table_filters | No | ||
| bgp_graph_time | Yes | ||
| large_community | No | ||
| as_path_contains | No | ||
| extended_community | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | ||
| pagination | Yes | ||
| sortable_columns | Yes |