Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Ipinfo io API

Give your agents access to Ipinfo io API. Bring your own Ipinfo io key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Ipinfo io

Instant

Ipinfo.io is an API service offering detailed IP address geolocation and network data. Instantly enrich user or device data with accurate location, privacy, and network insights.

27 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Ipinfo io without a separate account or API key for each one. New accounts start with $2 of free credit.

No Ipinfo io account or key

Your agent calls Ipinfo io through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.002 per 10 IP lookups, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Ipinfo io with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Ipinfo io API to your AI assistant

Use Ipinfo io from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use IPinfo through Composio Instant to look up 8.8.8.8. Return the available IP information in a readable summary.

What success looks like

IPINFO_IO_GET_IP_INFO_BY_IP

Your assistant runs IPinfo and replies with a readable summary of the available information for 8.8.8.8.

Runs on Composio Instant

SDK

Use the Ipinfo io API in your code

Call Ipinfo io from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
IPINFO_IO_GET_IP_INFO_BY_IP
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["ipinfo_io"],
    instant={
        "toolkits": {"enable": ["ipinfo_io"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "IPINFO_IO_GET_IP_INFO_BY_IP",
    arguments={
        "ip": "8.8.8.8",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["ipinfo_io"],
  instant: {
    toolkits: { enable: ["ipinfo_io"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "IPINFO_IO_GET_IP_INFO_BY_IP",
  {
    "ip": "8.8.8.8"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": "<IP information>",
  "error": "<error message or null>",
  "successful": "<true or false>",
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Ipinfo io API tools

12 Ipinfo io tools run on Instant, priced per call with no Ipinfo io key. Tools marked Your key need your own Ipinfo io account.

Action	Tool slug	What it does	Availability
Batch Lookup	IPINFO_IO_BATCH_LOOKUP	Look up geolocation and ASN information for multiple IP addresses.	Instant$0.002 per 10 IP lookups; each submitted IP counts as one lookup
Get IP Information	IPINFO_IO_GET_IP_INFO_BY_IP	Retrieve available information for an IPv4 or IPv6 address.	Instant$0.002 per 10 IP lookups
Get City by IP	IPINFO_IO_GET_CITY_BY_IP	Retrieve the city name for a specific IP address.	Instant$0.002 per 10 IP lookups
Get Country by IP	IPINFO_IO_GET_COUNTRY_BY_IP	Retrieve the two-letter ISO 3166 country code for an IP address.	Instant$0.002 per 10 IP lookups
Get Geo by IP	IPINFO_IO_GET_GEO_BY_IP	Get geolocation and basic IP details for an IPv4 or IPv6 address.	Instant$0.002 per 10 IP lookups
Get Hostname by IP	IPINFO_IO_GET_HOSTNAME_BY_IP	Retrieve the hostname (reverse DNS) for an IP address.	Instant$0.002 per 10 IP lookups
Get IP by IP	IPINFO_IO_GET_IP_BY_IP	Retrieve the IP address for a specified IP as plain text.	Instant$0.002 per 10 IP lookups
Get Location by IP	IPINFO_IO_GET_LOCATION_BY_IP	Retrieve geographic coordinates (latitude, longitude) for an IP address.	Instant$0.002 per 10 IP lookups
Get Organization by IP	IPINFO_IO_GET_ORG_BY_IP	Retrieve ASN and organization name for an IP address as plain text.	Instant$0.002 per 10 IP lookups
Get Postal Code by IP	IPINFO_IO_GET_POSTAL_BY_IP	Retrieve the postal/zip code for an IP address.	Instant$0.002 per 10 IP lookups
Get Region by IP	IPINFO_IO_GET_REGION_BY_IP	Retrieve the region/state for a specified IP address.	Instant$0.002 per 10 IP lookups
Get Timezone by IP	IPINFO_IO_GET_TIMEZONE_BY_IP	Retrieve the IANA timezone for a given IP address.	Instant$0.002 per 10 IP lookups
Get Company Info	IPINFO_IO_GET_COMPANY_INFO	Retrieve a company's name, domain, and type from an IP address.	Your key
Check IP Privacy	IPINFO_IO_GET_PRIVACY_DETAILS	Check an IP address for VPN, proxy, Tor, relay, and hosting flags.	Your key
Get Abuse Contact	IPINFO_IO_GET_ABUSE_CONTACT	Retrieve abuse contact or organization information for an IP address.	Your key
Map IP Addresses	IPINFO_IO_MAP_IPS	Create a map visualization from a list of IP addresses.	Your key

Instant prices are Ipinfo io's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Ipinfo io API use cases and example prompts

Copy a prompt into your agent. Each one uses Ipinfo io with apps you connect through Composio.

Summarize network locations
Use IPinfo to look up geolocation and ASN information for the IP addresses in my Network Review sheet in Google Sheets. Add the results to the sheet, then post a summary in Slack's #network-ops channel.
Apps used: Ipinfo io, Google Sheets, Slack
Review IPs in an incident
Use IPinfo to check the IP addresses in my open network incident in Jira for VPN, proxy, Tor, relay, and hosting flags. Add the results to the incident issue and post a summary in Slack's #security-ops channel.
Apps used: Ipinfo io, Jira, Slack
Enrich an account record
Use IPinfo to retrieve the company name, domain, and type for each IP address in the Acme row of my Prospects sheet in Google Sheets. Add those details to the Acme company record in HubSpot.
Apps used: Ipinfo io, Google Sheets, HubSpot
Map regional traffic
Use IPinfo to create a map visualization from the IP addresses in my Regional Traffic sheet in Google Sheets. Post the visualization in Slack's #network-ops channel with a note that it maps the addresses from the sheet.
Apps used: Ipinfo io, Google Sheets, Slack

TROUBLESHOOTING

Ipinfo io API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Set the filter parameter to true in IPINFO_IO_BATCH_LOOKUP to omit entries with null responses.

Connect your own IPinfo key to use IPINFO_IO_GET_PRIVACY_DETAILS.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Ipinfo io account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

Start with Ipinfo io.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Ipinfo io tool your agent needs.Free to start.

Start building

Ipinfo io API

What is Composio Instant?

No Ipinfo io account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Ipinfo io API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Ipinfo io API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Ipinfo io API tools

Ipinfo io API use cases and example prompts

Summarize network locations

Review IPs in an incident

Enrich an account record

Map regional traffic

Ipinfo io API troubleshooting

Batch results include entries with null responses

A lookup does not show VPN, proxy, or Tor flags

An action asks you to connect Ipinfo io

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Firecrawl

Tavily

Exa

Serpapi

Start with Ipinfo io.It takes 30 seconds.