Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Apiip - IP Geolocation 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%2Fapiip.net%2Fapiip" | shStep 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%2Fapiip.net%2Fapiip" | sh
jentic register # connects your agent to your Jentic One instanceJentic 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.
What an agent can do with Apiip - IP Geolocation API.
Resolve the caller's own IP address to location data
Look up geolocation details for a specified IP address
Resolve several IP addresses in a single batch request
Return country, region, city, and coordinate data
Return currency, timezone, and connection details for an IP
GET STARTED
Patterns agents use Apiip - IP Geolocation API for, with concrete tasks.
★ Localize content by visitor IP
Websites and apps tailor content to where a visitor is. The Apiip API resolves the caller's IP to its country, region, city, and currency, so an integration can pick the right language, currency, or regional offer without asking the user.
Resolve the current visitor's IP address and return the country and preferred currency.
Enrich records with location data
Analytics and security workflows enrich logged IP addresses with geographic context. The API looks up any supplied address and returns region, city, coordinates, timezone, and connection details, letting an integration annotate records for reporting or risk scoring.
Given an IP address, return its city, coordinates, and timezone.
Batch-resolve many addresses
Backfilling location data for a set of stored IPs is slow one call at a time. The API accepts several addresses in one request and returns their geolocation details together, so an integration can process a list efficiently.
Given a list of IP addresses, resolve them in one request and return each location.
Let an agent geolocate IP addresses
An AI agent that handles support or security tasks can attach location context to an IP on demand. Through Jentic the agent discovers the lookup by intent and runs it under the integration's own API key, returning country, city, and timezone for the address in question.
Given an IP from a support ticket, return the country, city, and timezone to the user.
3 endpoints — the apiip api resolves ip addresses to geographic and network details over a rest interface.
METHOD
PATH
DESCRIPTION
/api/check
Resolve the caller's own IP address
/api/check/{ip}
Resolve a specified IP address
/api/check/{ips}
Resolve several IP addresses in one request
/api/check
Resolve the caller's own IP address
/api/check/{ip}
Resolve a specified IP address
/api/check/{ips}
Resolve several IP addresses in one request
What agents get from Jentic-routed access to this vendor.
Setup
Wiring up IP geolocation yourself means integrating the endpoint, tracking the API key, and handling batch requests. With Jentic you install once, import Apiip from the Directory, and store the access key a single time.
Permission scoping
Running Jentic in your own instance, you decide which Apiip operations the agent may call, so you can allow single lookups while withholding batch lookups. Access is granted per operation.
Credential isolation
Your Apiip access key is held encrypted by your own Jentic One instance and injected only when a lookup runs, so it never appears in the agent's prompt, logs, or context.
Intent-based discovery
Agents find Apiip through Jentic's intent search: a request like resolve this IP to a country resolves to the right operation with inputs and auth prepared.
Alternatives and complements available in the Jentic catalogue.
Specific to using Apiip - IP Geolocation API through Jentic.
Is there an MCP server for the Apiip API?
You do not need a dedicated MCP server. Through Jentic your self-hosted agent can call Apiip lookups directly by intent, so you connect the API without maintaining separate MCP tooling.
Can I limit which Apiip operations my agent is allowed to call?
Yes. Because you run Jentic yourself, you decide which Apiip operations your agent can call, so you can allow single lookups while withholding batch lookups if you wish. Scoping is applied per operation.
What authentication does the Apiip API use?
Apiip authenticates with an API key sent as the `accessKey` query parameter. Jentic injects the key from your stored credential when a lookup runs, so it never appears in your agent's prompt.
Can Apiip resolve more than one IP address at a time?
Yes. Alongside single-address lookups, the API accepts several IP addresses in one request and returns each address's location data together.
What data does an Apiip lookup return?
A lookup returns country, region, city, and coordinates along with currency, timezone, and connection details for the address, so you can localize content or enrich records.
How does an agent find the Apiip lookup in Jentic?
The agent searches Jentic by intent, such as resolving an IP to its country, and Jentic returns the matching Apiip operation ready to run under your credentials.
For Agents
Lets an AI agent resolve IP addresses to location, currency, and timezone data, including batch lookups of several addresses at once.
Use for: I need to find the country and city for a visitor's IP address, Look up the timezone for a given IP address, Resolve the location of my current IP address, Get the currency used at a specific IP location
Not supported: Resolves IP addresses to location and network data only; it does not geocode street addresses or provide mapping tiles, so pair it with a geocoding service for address lookups.
The Apiip API resolves IP addresses to geographic and network details over a REST interface. It returns the country, region, city, coordinates, currency, timezone, and connection data for the caller's own IP or any address supplied, and it can look up several addresses in a single request. Calls authenticate with an API key passed as a query parameter.