# BigDataCloud — how to use (mcp.ai)

Connect your BigDataCloud account and use 17 tools for developer tools straight from your AI agent. Connect with your own API key. BigDataCloud offers a suite of APIs providing geolocation, reverse geocoding, and data validation services.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_big_data_cloud?ms=1787291160000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `big_data_cloud_am_i_roaming_api`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/big_data_cloud`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/big_data_cloud/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/big_data_cloud/am/i/roaming/api` — Tool to determine if the user is roaming based on their IP address and GPS coordinates. Use after obtaining device location to verify roaming status before mobile actions.
  - body: { latitude: number, longitude: number }
- `POST https://api.mcp.ai/api/big_data_cloud/asn/extended/receiving/from/info/api` — Tool to return upstream providers (receivingFrom) for a given ASN. Use when you need a paginated list of ASes feeding traffic for the specified ASN.
  - body: { asn: string, offset: integer, batchSize: integer, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/asn/extended/transit/to/info/api` — Tool to return downstream customers (transitTo) for a given ASN. Use when you need a paginated list of ASes receiving traffic from a specific ASN.
  - body: { asn: string, offset: integer, batchSize: integer, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/asn/rank/list/api` — Retrieves a ranked list of Autonomous Systems (ASNs) sorted by IPv4 address announcement volumes. Use cases: - Find the largest ASNs by IP address count (DoD, Amazon, Microsoft, etc.) - Look up ASN ra
  - body: { sort?: string, order?: string, offset?: integer, batchSize?: integer, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/bgp/active/prefixes/api` — Tool to retrieve IPv4 or IPv6 prefixes currently announced on BGP. Use when inspecting BGP routing announcements for a given ASN.
  - body: { asn: string, isv4?: boolean, sort?: string, order?: string, offset?: integer, batchSize?: integer, bogonsOnly?: boolean, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/country/by/ip/address/api` — Tool to geolocate an IP address and retrieve country details and demographics. Use when you need country-level data after obtaining the target IP address.
  - body: { ip?: string, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/country/info/api` — Tool to fetch detailed country information by ISO code. Use when you need localized names, currencies, regions, and other metadata for a country.
  - body: { code: string, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/email/address/verification/api` — Tool to verify email addresses for syntax, domain validity, and disposability. Use after obtaining the email input.
  - body: { emailAddress: string }
- `POST https://api.mcp.ai/api/big_data_cloud/hazard/report/api` — Tool to fetch a cybersecurity hazard report for a specified IP address. Use when assessing an IP's threat profile (VPN, proxy, blacklists, hosting risk).
  - body: { ip?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/network/by/cidr` — Tool to retrieve BGP-announced networks within a specified CIDR range. Use when you need to analyze network announcements within a particular CIDR after confirming the range format.
  - body: { cidr: string, bogonsOnly?: boolean, depthLimit?: integer, subnetsOffset?: integer, localityLanguage?: string, subnetsBatchSize?: integer }
- `POST https://api.mcp.ai/api/big_data_cloud/network/by/ip/address/api` — Tool to retrieve registry, ASN, and BGP details for a given IP address’s network. Use when you need detailed network information (e.g., ASNs, prefixes) after confirming the target IP.
  - body: { ip?: string, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/phone/number/validation/by/ip` — Tool to validate phone numbers by inferring country from client IP. Use when you want to validate a number without specifying country.
  - body: { ip?: string, number: string, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/reverse/geocoding/timezone/api` — Tool to return reverse geocoding and time zone info for given coordinates. Use when you need both locality details and timezone data in one call.
  - body: { latitude: number, longitude: number, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/time/zone/by/ip/address/api` — Tool to retrieve time zone information for a given IP address. Use when you need DST status, UTC offsets, and local/UTC time for a specific IP.
  - body: { ip?: string, utcReference?: integer }
- `POST https://api.mcp.ai/api/big_data_cloud/tor/exit/nodes/geolocated/api` — Retrieve a paginated list of active TOR exit node IP addresses with geolocation and carrier (ASN) details. Use this tool to: - Get a list of known TOR exit node IPs to detect/block anonymous traffic -
  - body: { sort?: string, order?: string, offset?: integer, batchSize?: integer, localityLanguage?: string }
- `POST https://api.mcp.ai/api/big_data_cloud/user/agent/parser/api` — Tool to parse a User-Agent string into device, OS, browser, and bot details. Use when you have a raw User-Agent header and need structured client info.
  - body: { userAgentRaw: string }
- `POST https://api.mcp.ai/api/big_data_cloud/user/risk/api` — Tool to return a risk assessment for a user based on IP signals for fraud prevention. Use after initial IP checks to decide whether to bypass or require captcha challenges.
  - body: { ip?: string }

## Example prompts
- "What can I do in BigDataCloud?"
- "Show me a summary of my BigDataCloud account"

## More
- Page: https://mcp.ai/big_data_cloud
- Agent spec (llms.txt): https://mcp.ai/big_data_cloud/llms.txt
- Postman collection: https://mcp.ai/big_data_cloud/postman.json