Can I use IPstack as a CLI?

Yes. KosmoKrator exposes a IPstack CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose IPstack through MCP?

Yes. The KosmoKrator MCP gateway can expose selected IPstack tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are IPstack credentials stored?

IPstack credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for IPstack MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

IPstack CLI for AI Agents

Use the IPstack CLI from KosmoKrator to call IPstack tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

IPstack CLI Setup

IPstack can be configured headlessly with `kosmokrator integrations:configure ipstack`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure ipstack --set api_key="$IPSTACK_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor ipstack --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`IPSTACK_API_KEY`	Secret `secret`	yes	API Key
`url`	`IPSTACK_URL`	URL `url`	no	API Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call ipstack.ipstack_lookup_ip '{"ip":"example_ip","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Provider shortcut

kosmo integrations:ipstack ipstack_lookup_ip '{"ip":"example_ip","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs ipstack --json
kosmo integrations:docs ipstack.ipstack_lookup_ip --json
kosmo integrations:schema ipstack.ipstack_lookup_ip --json
kosmo integrations:search "IPstack" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`ipstack.ipstack_lookup_ip`

Look up geolocation data for a single IP address using IPstack. Returns country, region, city, coordinates, and more.

Read read

Parameters: ip, fields, hostname, security, language

Generic call

kosmo integrations:call ipstack.ipstack_lookup_ip '{"ip":"example_ip","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Shortcut

kosmo integrations:ipstack ipstack_lookup_ip '{"ip":"example_ip","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

`ipstack.ipstack_lookup_bulk`

Look up geolocation data for multiple IP addresses at once (up to 50). Returns an array of geolocation results.

Read read

Parameters: ips, fields, hostname, security, language

Generic call

kosmo integrations:call ipstack.ipstack_lookup_bulk '{"ips":"example_ips","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Shortcut

kosmo integrations:ipstack ipstack_lookup_bulk '{"ips":"example_ips","fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

`ipstack.ipstack_lookup_requester`

Detect and geolocate the IP address making the API request using the official IPstack /check endpoint.

Read read

Parameters: fields, hostname, security, language

Generic call

kosmo integrations:call ipstack.ipstack_lookup_requester '{"fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Shortcut

kosmo integrations:ipstack ipstack_lookup_requester '{"fields":"example_fields","hostname":true,"security":true,"language":"example_language"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

ipstack.ipstack_lookup_ip 5 parameters

Schema command

kosmo integrations:schema ipstack.ipstack_lookup_ip --json

Parameter	Type	Required	Description
`ip`	string	yes	The IPv4 or IPv6 address or domain to look up (e.g., "134.201.250.155").
`fields`	array	no	Optional response fields, such as ["main", "location", "timezone", "currency", "connection", "security"].
`hostname`	boolean	no	Set true to request hostname lookup.
`security`	boolean	no	Set true to request the paid security module.
`language`	string	no	Response language code (e.g., "en", "de", "fr"). Defaults to English.

ipstack.ipstack_lookup_bulk 5 parameters

Schema command

kosmo integrations:schema ipstack.ipstack_lookup_bulk --json

Parameter	Type	Required	Description
`ips`	array	yes	Array of IPv4 or IPv6 addresses or domains to look up (max 50, e.g., ["134.201.250.155", "72.229.28.185"]).
`fields`	array	no	Optional response fields, such as ["main", "location", "timezone", "currency", "connection", "security"].
`hostname`	boolean	no	Set true to request hostname lookup.
`security`	boolean	no	Set true to request the paid security module.
`language`	string	no	Response language code (e.g., "en", "de", "fr"). Defaults to English.

ipstack.ipstack_lookup_requester 4 parameters

Schema command

kosmo integrations:schema ipstack.ipstack_lookup_requester --json

Parameter	Type	Required	Description
`fields`	array	no	Optional response fields, such as ["main", "location", "timezone", "currency", "connection", "security"].
`hostname`	boolean	no	Set true to request hostname lookup.
`security`	boolean	no	Set true to request the paid security module.
`language`	string	no	Response language code (e.g., "en", "de", "fr"). Defaults to English.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.