Tool Reference

MCP Tool Reference

This ip-api.io MCP tool reference lists every tool exposed by the hosted MCP server. Customer-facing tools require api_key and return the same data shapes used by the REST API.

Shared rules

  • Endpoint: https://ip-api.io/mcp
  • Transport: Streamable HTTP
  • All customer-facing tools require api_key
  • api_type, when accepted, must be IP or ADVANCED_EMAIL_VALIDATION
  • start_date and end_date are ISO-8601 datetimes such as 2026-06-01T00:00:00Z
1

Example tool calls

{
  "name": "risk_score",
  "arguments": {
    "api_key": "YOUR_API_KEY",
    "ip": "8.8.8.8",
    "email": "user@example.com"
  }
}
{
  "name": "email_validate_advanced_batch",
  "arguments": {
    "api_key": "YOUR_API_KEY",
    "emails": ["user@example.com", "sales@example.org"]
  }
}
Reference

Tools and arguments

Optional arguments are marked with ?. Arrays use JSON arrays of strings.

Area Tool Arguments Use
IP intelligence ip_lookup api_key, ip Geolocation, ASN, ISP, timezone, and suspicious factors for one IP.
ip_lookup_self api_key Same lookup for the MCP HTTP peer IP.
ip_lookup_batch api_key, ips Batch IP lookup for 1 to 100 IP addresses.
Risk and reputation risk_score api_key, ip, email? Fraud score for an IP, optionally correlated with an email.
risk_score_self api_key, email? Fraud score for the MCP HTTP peer IP.
email_risk_score api_key, email Fraud score for an email without IP correlation.
ip_reputation api_key, ip Composite reputation score and risk-factor breakdown for an IP.
tor_check api_key, ip Tor exit-node check for an IP address.
Email validation email_validate api_key, email Syntax, disposable-domain status, and MX records.
email_validate_advanced api_key, email SMTP, deliverability, role-account, free-provider, and Gravatar checks.
email_validate_advanced_batch api_key, emails Advanced validation for 1 to 100 email addresses.
email_validate_advanced_batch_csv api_key, csv_content Advanced validation from CSV text, first column as email.
Network and domain asn_lookup api_key, ip ASN, organization, network prefix, and datacenter classification.
dns_mx api_key, domain MX records for a domain.
dns_whois api_key, domain Structured WHOIS data for a domain.
dns_reverse api_key, ip PTR hostname for an IP address.
dns_forward api_key, hostname A and AAAA records for a hostname.
domain_age api_key, domain Domain registration date and age.
domain_age_batch api_key, domains Domain age lookup for multiple domains.
Account and usage rate_limit_info api_key Plan, quota limits, remaining requests, and renewal date.
usage_stats api_key, start_date, end_date, api_type? Hourly usage rows for an ISO-8601 date range up to 90 days.
usage_summary api_key, start_date, end_date, api_type? Aggregated usage summary for an ISO-8601 date range.
usage_recent api_key, api_type? Detailed usage for the last 24 hours.
usage_current_month api_key, api_type? Aggregated usage for the current calendar month.
Public api_status - Health status for the API and MCP server.
Quota: IP, DNS, domain, Tor, reputation, fast-email, and risk tools use IP quota. Advanced email tools use advanced-email quota. Usage and quota tools require a valid key but do not consume lookup quota.
2

CSV batch input

MCP cannot use browser multipart uploads directly, so email_validate_advanced_batch_csv accepts CSV text in csv_content. The first column is treated as the email column, headers are optional, and content must be 1 MB or smaller. 

{
  "name": "email_validate_advanced_batch_csv",
  "arguments": {
    "api_key": "YOUR_API_KEY",
    "csv_content": "email\nuser1@example.com\nuser2@example.org\n"
  }
}
3

Self IP tools

ip_lookup_self and risk_score_self inspect the MCP HTTP request peer IP. If an MCP client runs in a hosted environment, the peer IP may be the host service egress address. For end-user fraud screening, pass the user IP explicitly to ip_lookup or risk_score.

Need another tool shape?

If a client needs different argument names, batching behavior, or response handling, send us the MCP client details and target workflow.

Contact Support

Need SDK docs?

The official SDKs expose the same API surface for backend integrations that do not use MCP.

View SDKs