Install Jentic One Beta

Connect the BGP.tools API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the BGP.tools API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbgptools%2Fbgptools" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbgptools%2Fbgptools" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with BGP.tools API.

Export the full IPv4 and IPv6 BGP routing table as plaintext or JSONL

Look up ASN-to-organisation name mappings across the global routing system

Retrieve the list of curated tags used by BGP.tools to classify networks

Download the members of a specific tag (such as anycast or hosting) as CSV

Identify which prefixes are originated by a given autonomous system

GET STARTED

Start building with BGP.tools API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use BGP.tools API for, with concrete tasks.

★ IP-to-ASN Enrichment Pipeline

Build an offline IP-to-ASN lookup service by ingesting the BGP.tools routing table once per hour and indexing the prefix-to-ASN map locally. The /table.jsonl endpoint streams every announced prefix with its origin ASN, which lets you classify any inbound IP address by its network owner. Typical setup time is under a day; the enrichment service can serve millions of lookups per second from memory.

Download /table.jsonl, parse each line into (prefix, asn) tuples, and build an in-memory radix tree for IP-to-ASN lookups.

Network Classification with Tags

Detect whether traffic originates from a hosting provider, anycast network, or government ASN by joining inbound IP addresses against BGP.tools tag lists. Tag membership is curated by the BGP.tools team and updated continuously; agents can pull /tags/{tagname}.csv for any tag listed in /tags.txt and use it to flag suspicious or expected traffic patterns.

Fetch /tags/hosting.csv and produce a deduplicated set of ASNs flagged as hosting providers.

Network Operator Reachability Reports

Generate a reachability report for a specific ASN by cross-referencing the BGP.tools routing table to find every prefix it currently originates. This is useful for network operators verifying their announcements are visible globally, or for security teams auditing the address space owned by a customer's ASN.

Filter /table.jsonl for entries where origin_asn equals 13335 and return the full list of prefixes Cloudflare announces.

AI Agent Network Forensics Assistant

An AI agent helping a SOC analyst can answer questions like 'who owns this IP?' and 'is this address space hosting infrastructure?' by calling BGP.tools through Jentic. The agent does not need to handle the User-Agent header convention manually - Jentic injects it from the stored credential. ASN context is returned as plain CSV or JSONL that the agent can summarise.

Search Jentic for 'asn name lookup', execute /asns.csv, and return the organisation name for ASN 15169.

Key Endpoints

6 endpoints — the bgp.

METHOD

PATH

DESCRIPTION

GET

/table.txt

Routing table as plaintext

GET

/table.jsonl

Routing table as JSONL stream

GET

/asns.csv

ASN to name mappings

GET

/tags.txt

List all available tags

GET

/tags/{tagname}.csv

Members of a tag as CSV

GET

/table.txt

Routing table as plaintext

GET

/table.jsonl

Routing table as JSONL stream

GET

/asns.csv

ASN to name mappings

GET

/tags.txt

List all available tags

GET

/tags/{tagname}.csv

Members of a tag as CSV

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the BGP.tools API by hand means sending the required User-Agent identifier on every request and parsing its plain-text, JSONL, and CSV table exports yourself. Through Jentic you install once, import BGP.tools from the API Directory, store the identifier once, and your agent calls it.

Permission scoping

BGP.tools exposes fixed export files with the tag name in the path (/tags/{tagname}.csv), so limit the agent to the operations it needs, such as fetching the routing table or ASN list. You choose that set, so tag exports are not reachable unless you include them, and every operation is a read-only export.

Credential isolation

Your BGP.tools User-Agent identifier is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'export the BGP routing table' or 'map an ASN to an organisation', and Jentic returns the matching BGP.tools operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using BGP.tools API through Jentic.

What authentication does the BGP.tools API use?

BGP.tools requires a custom User-Agent header on every request that identifies the caller (project name and contact email is the convention). The OpenAPI spec models this as an apiKey scheme on the User-Agent header. Through Jentic, the User-Agent value is stored encrypted in your Jentic One instance and injected at execution time so the agent never sees the raw value.

Can I get the full BGP routing table from the BGP.tools API?

Yes. GET /table.txt returns the routing table in plaintext, and GET /table.jsonl returns the same data as newline-delimited JSON, which is more practical for streaming ingestion into a pipeline. Both endpoints cover the global IPv4 and IPv6 announced prefixes.

What are the rate limits for the BGP.tools API?

BGP.tools does not publish hard rate limits in the spec, but the operators ask for a real, contactable User-Agent and request that bulk consumers cache results rather than re-downloading the multi-megabyte table on every request. Refresh hourly at most for the routing table; tag lists change less frequently.

How do I look up an ASN through Jentic?

Search Jentic for 'asn name mapping' or 'GET /asns.csv', load the schema, and execute. With the SDK: pip install jentic, then SearchRequest, LoadRequest, and ExecutionRequest in an async flow - Jentic injects the configured User-Agent automatically.

Is the BGP.tools API free?

Yes - the data export endpoints are free for use as long as you provide a contactable User-Agent so the operators can reach you if your usage causes problems. There is no commercial tier specified in the OpenAPI spec.

Can I limit what my agent is allowed to do with the BGP.tools API?

Yes. Because Jentic One is self-hosted, you decide which BGP.tools operations your agent may call and which credential it uses, so you can allow only the exports it needs, such as the routing table (GET /table.jsonl) or the ASN-to-name mappings (GET /asns.csv). Every BGP.tools operation is a read-only export, and the tag exports (GET /tags/{tagname}.csv) are not reachable unless you include them in that set. The stored User-Agent identifier is injected at execution time and never enters the agent's context.

BGP.tools API

Name: BGP.tools API
Brand: BGP.tools API
Availability: InStock

Official vendor OpenAPI document · agent-readyDeveloper ToolsMonitoring ObservabilityapiKey6 EndpointsREST

For Agents

Export the global BGP routing table, ASN-to-name mappings, and curated network tags from BGP.tools for IP intelligence and network research.

Use for: I need to download the current global BGP routing table, Get the ASN-to-name mapping for all autonomous systems, List all available BGP.tools tags, Find every prefix tagged as anycast

Not supported: Does not handle IP geolocation, abuse reporting, or whois lookups - use for BGP routing table exports and ASN-to-organisation mappings only.

The BGP.tools API exports BGP routing data sourced from a global view of the Internet routing table. It returns the full IPv4 and IPv6 prefix-to-ASN routing table, ASN-to-organisation mappings, and curated tag lists used to flag networks (for example anycast, hosting, or government). All requests must include a custom User-Agent header that identifies the requester so the operators can contact heavy users. Output is plaintext, CSV, or JSONL - there is no JSON object response.

Jentic One on Github View OpenAPI Document