# Ipdata co

```json
{
  "name": "Ipdata co",
  "slug": "ipdata_co",
  "url": "https://composio.dev/toolkits/ipdata_co",
  "markdown_url": "https://composio.dev/toolkits/ipdata_co.md",
  "logo_url": "https://ipdata.co/static/images/ipdata-logo.png",
  "categories": [
    "data & analytics"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:16:18.761Z"
}
```

![Ipdata co logo](https://ipdata.co/static/images/ipdata-logo.png)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Ipdata co MCP or direct API to look up IP geolocation, check threat profiles, identify ownership, and evaluate risk scores through natural language.

## Summary

Ipdata co is an API service that provides detailed geolocation, ownership, and threat insights for any IP address. Use it to instantly identify, analyze, and assess the risk profile of IPs in your applications.

## Categories

- data & analytics

## Toolkit Details

- Tools: 28

## Images

- Logo: https://ipdata.co/static/images/ipdata-logo.png

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Ipdata.co.
  - Setup:
    - Configure Api Key credentials for Ipdata.co.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Get city and country for this IP address
- Check if this IP is from the EU
- Find mobile carrier for a given IP
- Show my API usage count for today

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `IPDATA_CO_ADVANCED_ASN_LOOKUP` | Advanced ASN Lookup | Tool to perform advanced ASN lookup returning prefixes, peers, and registry details. Use after confirming ASN number when detailed ASN info is required. |
| `IPDATA_CO_EU_LOOKUP_SPECIFIC_IP` | EU IP Lookup (Specific IP) | Lookup geolocation, threat intel, and network data for a specific IP address using the EU data residency endpoint. Use this tool when: - You need IP lookup with GDPR compliance (data processed and stored only within EU datacenters) - Looking up any IPv4 or IPv6 address for location, ASN, threat, or company information The EU endpoint (eu-api.ipdata.co) ensures all API requests are routed through EU-based servers in Frankfurt, Paris, and Ireland. |
| `IPDATA_CO_FIELD_CALLING_CODE` | IPData: Calling Code | Tool to fetch the international calling_code for an IP's country. Use when you need only the calling code field from ipdata_co. |
| `IPDATA_CO_FIELD_CARRIER` | IPDATA Field Carrier | Retrieve mobile carrier information (name, MCC, MNC) for an IP address. Returns carrier data only for mobile network IPs; non-mobile IPs return null fields. |
| `IPDATA_CO_FIELD_CITY` | Get City from IP | Tool to return only city for an IP. Use when only the city name is required. |
| `IPDATA_CO_FIELD_CONTINENT_CODE` | IPData: Continent Code | Retrieve the continent code for a given IP address. Returns a two-letter code (AF, AN, AS, EU, NA, OC, SA) indicating which continent the IP is geographically located in. Use this when you only need the continent information without full IP geolocation details. |
| `IPDATA_CO_FIELD_CONTINENT_NAME` | Get Continent Name from IP | Tool to return only continent name for an IP. Use when only the continent name is required. |
| `IPDATA_CO_FIELD_COUNT` | IPDATA Field Count | Tool to return only the request count made by your API key in the last 24 hours. Use when monitoring your API usage and you only need the total count. |
| `IPDATA_CO_FIELD_COUNTRY_CODE` | IPData: Country Code | Tool to return only country_code for an IP. Use when only the 2-letter country code is required. |
| `IPDATA_CO_FIELD_COUNTRY_NAME` | Get Country Name from IP | Get the country name for an IP address using ipdata.co geolocation API. Returns only the country name (e.g., 'United States', 'Germany', 'Japan'). Use this lightweight action when you only need the country name without full IP details. |
| `IPDATA_CO_FIELD_CURRENCY` | IPDATA Field Currency | Tool to return only currency object for an IP. Use when currency details are needed. |
| `IPDATA_CO_FIELD_EMOJI_FLAG` | Get Emoji Flag from IP | Tool to return only emoji flag for an IP. Use when only the country flag emoji is required. |
| `IPDATA_CO_FIELD_EMOJI_UNICODE` | Get Emoji Unicode from IP | Tool to return only emoji_unicode for an IP. Use when only the Unicode country flag emoji is required. |
| `IPDATA_CO_FIELD_IP` | IPData: IP | Retrieve the public IP address of the calling client. This action calls the IPData API to determine the caller's external/public IP address. It returns only the IP string with no additional geolocation data. Use this when you need to identify your own public IP address. |
| `IPDATA_CO_FIELD_IS_EU` | IPData: Is EU | Tool to return only is_eu for an IP. Use when you need to determine if an IP's country belongs to the EU. |
| `IPDATA_CO_FIELD_LANGUAGES` | IPData: Languages | Tool to return only the languages array for an IP. Use when only language details for an IP are required. |
| `IPDATA_CO_FIELD_LATITUDE` | IPData: Latitude | Tool to return only the latitude for an IP. Use when only the latitude coordinate is needed. |
| `IPDATA_CO_FIELD_LONGITUDE` | Get Longitude from IP | Tool to return only longitude for an IP. Use when only the longitude value is required. |
| `IPDATA_CO_FIELD_POSTAL` | IPData: Postal Code | Tool to return only postal code for an IP. Use when only the postal code (ZIP/postcode) is required. |
| `IPDATA_CO_FIELD_REGION` | Get Region from IP | Tool to return only region for an IP. Use when only the region name is required. |
| `IPDATA_CO_FIELD_REGION_CODE` | IPData: Region Code | Tool to return only region_code for an IP. Use when only the ISO 3166-2 region code is required. |
| `IPDATA_CO_FIELD_THREAT` | Get Threat for IP | Retrieve threat intelligence data for a specific IP address or the calling IP. Returns indicators such as Tor exit node status, proxy detection, datacenter/cloud provider identification, known attacker/abuser flags, and blocklist appearances. Use this tool when you need to assess the security risk or reputation of an IP address. |
| `IPDATA_CO_FIELD_TIME_ZONE` | IPData: Time Zone | Tool to return only the time_zone object for an IP. Use when only timezone data is required. |
| `IPDATA_CO_IP_DATA_BASIC_ASN_FOR_IP` | IPData Basic ASN for IP | Tool to return basic ASN data for a specific IP. Use when you need ASN number, organization, domain, route, and type details. |
| `IPDATA_CO_IPDATA_BULK_LOOKUP_V1` | IPData Bulk Lookup V1 | Tool to bulk lookup up to 100 IP addresses via ipdata.co. Use when you have multiple IPs and need geolocation and threat data in one call. |
| `IPDATA_CO_IP_DATA_COMPANY_FOR_IP` | Get company data for IP | Tool to retrieve company data for a given IP address. Use when you need the organization name, domain, network prefix, and usage type for an IPv4 or IPv6. |
| `IPDATA_CO_IPDATA_EU_LOOKUP_CALLING_IP` | EU IP Lookup (Calling IP) | Lookup geolocation, network, and threat data for the calling client's IP address using the EU-residency endpoint. Use this action when you need IP data processed and stored entirely within the European Union (GDPR compliance). The EU endpoint routes requests only through EU datacenters (Frankfurt, Paris, Ireland). This action automatically detects and returns data for the IP address making the API request. No IP address parameter is needed. |
| `IPDATA_CO_IP_DATA_LOOKUP_IP_V1` | IPData Lookup IP V1 | Tool to lookup comprehensive IP information (geolocation, network, company, and threat data) in one call. Use when you need all IP insights together. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Ipdata co Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Ipdata co actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Get the city and country for IP address 8.8.8.8'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Get the city and country for IP address 8.8.8.8'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Ipdata co tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Get city for IP address 8.8.8.8')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Get city for IP address 8.8.8.8' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Ipdata co Integration

- Supports both Ipdata co MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Ipdata co data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Ipdata co access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Ipdata co
- Scoped, least privilege access to Ipdata co resources
- Full audit trail of agent actions to support review and compliance

## Use Ipdata co with any AI Agent Framework

Choose a framework you want to connect Ipdata co with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/ipdata_co/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/ipdata_co/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/ipdata_co/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/ipdata_co/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/ipdata_co/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/ipdata_co/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/ipdata_co/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/ipdata_co/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/ipdata_co/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/ipdata_co/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/ipdata_co/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/ipdata_co/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/ipdata_co/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/ipdata_co/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/ipdata_co/framework/autogen)

## Related Toolkits

- [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.
- [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.
- [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions.
- [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows.
- [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations.
- [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements.
- [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.
- [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots.
- [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches.
- [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand.
- [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance.
- [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows.
- [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses.
- [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research.
- [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction.
- [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation.
- [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation.
- [Cabinpanda](https://composio.dev/toolkits/cabinpanda) - Cabinpanda is a data collection platform for building and managing online forms. It helps streamline how you gather, organize, and analyze responses.

## Frequently Asked Questions

### Do I need my own developer credentials to use Ipdata co with Composio?

Yes, Ipdata co requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)