> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to IP2Location.io

The IP2Location.io connector lets your AI agent act in each user's IP2Location.io account. Each user connects their own IP2Location.io access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 4 tools.

**Authentication:** Bearer Token
**Categories:** Developer Tools, Analytics
**Tools:** 4: 3 read, 1 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=IP2LOCATIONIO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the IP2Location.io connection

   In **AgentKit > Connections**, create an IP2Location.io connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'ip2locationio'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize IP2Location.io:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'ip2locationio_ip_lookup',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "ip2locationio"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize IP2Location.io:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="ip2locationio_ip_lookup",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their IP2Location.io credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'ip2locationio_domain_whois_get',
  toolInput: {
    domain: '<domain>',
  },
  connector: 'ip2locationio',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="ip2locationio_domain_whois_get",
    tool_input={
        "domain": "<domain>",
    },
    connection_name="ip2locationio",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `ip2locationio_domain_whois_get`

Get Domain WHOIS · Read-only

Look up the WHOIS record of a domain name through IP2WHOIS.
Returns domain, domain_id, status, create_date, update_date, expire_date, domain_age, whois_server, registrar, registrant, admin, tech and billing contacts, and nameservers.
Use this for domain ownership and expiry. Use ip2locationio_hosted_domains_list for the domains on an IP address.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `domain` (`string`, required): Domain name to look up, without a protocol or path. Example: locaproxy.com.

Example input: `{"domain":"<domain>"}`

### `ip2locationio_hosted_domains_list`

List Hosted Domains · Read-only

List the domain names hosted on an IP address.
Returns ip, total_domains, page, per_page, total_pages and domains.
Use this to see what sites share a server. Increase page until total_pages to read them all.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ip` (`string`, required): IPv4 or IPv6 address to look up. Example: 8.8.8.8.
- `page` (`integer`, optional): Page of hosted domains to return. Defaults to the first page. Example: 1.

Example input: `{"ip":"<ip>"}`

### `ip2locationio_ip_lookup`

Look Up IP Geolocation · Read-only

Look up the geolocation, network and proxy details of one IPv4 or IPv6 address.
Returns ip, country_code, country_name, region_name, city_name, latitude, longitude, zip_code, time_zone, asn, as and is_proxy; Starter, Plus and Security plans add ISP, domain, usage type, proxy, fraud score and more.
Use this for one address. Use ip2locationio_ip_bulk_lookup for many addresses at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ip` (`string`, optional): IPv4 or IPv6 address to look up. Defaults to the address making the request. Example: 8.8.8.8.
- `lang` (`string`, optional): ISO 639-1 language for continent, country, region and city name translations. Plus and Security plans only; other plans return error 10004. Example: de. One of: `ar`, `cs`, `da`, `de`, `en`, `es`, `et`, `fi`, `fr`, `ga`, `it`, `ja`, `ko`, `ms`, `nl`, `pt`, `ru`, `sv`, `tr`, `vi`, `zh-cn`, `zh-tw`.

Example input: `{}`

### `ip2locationio_ip_bulk_lookup`

Bulk Look Up IP Geolocation · Write

Look up the geolocation, network and proxy details of many IP addresses in one request. Needs a paid IP2Location.io plan.
Returns one result object per IP address with the same fields as a single lookup, limited to fields if you set it.
Use this for a list of addresses. Use ip2locationio_ip_lookup for one address.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `ips` (`array`, required): IPv4 or IPv6 addresses to look up. Example: ["1.1.1.1", "2.2.2.2"]
- `fields` (`string`, optional): Comma-separated response fields to return, such as country_code, city_name, isp, proxy.is_vpn or time_zone_info.olson. Defaults to every field your plan includes. Example: country_code,city_name,isp,proxy.is_vpn.

Example input: `{"ips":["1.1.1.1","2.2.2.2"]}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
