MCP Server

ip-api.io MCP Server

Q: What transport does the ip-api.io MCP server use?

The hosted server uses MCP Streamable HTTP at https://ip-api.io/mcp. Configure your MCP client with that URL and call tools with your ip-api.io API key in the api_key argument.

Q: How do MCP tools authenticate?

Customer-facing tools require api_key as a tool argument. Keep the key in your MCP client or agent secret store and do not paste it into user-visible prompts.

Give AI agents controlled access to ip-api.io intelligence over Model Context Protocol. The hosted remote MCP server exposes read-only tools for IP lookup, fraud risk, email validation, DNS, domain age, quota, and usage data.

Get free API key Tool Reference

Trusted by thousands of businesses

Fast JSON API responses

Real-time validation

Simple integration, SDKs & examples

Endpoint

Transport: MCP Streamable HTTP
MCP API URL: https://ip-api.io/mcp
Authentication: pass api_key in each customer-facing tool call
Public health tool: api_status

Add the hosted Streamable HTTP MCP endpoint to any MCP client that supports remote HTTP servers. Keep your API key in a secret store and provide it only as a tool argument.

{
  "mcpServers": {
    "ip-api-io": {
      "url": "https://ip-api.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Tool calls use the same quota pools and response fields as the REST API. This example returns geolocation and security flags for an IP address.

{
  "name": "ip_lookup",
  "arguments": {
    "api_key": "YOUR_API_KEY",
    "ip": "8.8.8.8"
  }
}

For batch tools, send arrays. Batch IP and advanced-email tools accept up to 100 items and charge one quota unit per unique processed item.

Tools ending in _self use the MCP HTTP request peer IP. For hosted or cloud MCP clients, that may be the client service egress IP rather than an end user's browser or device IP. Use explicit IP tools when you need to analyze an application user.

Best practice: call ip_lookup or risk_score with the IP address collected by your own backend when making fraud or compliance decisions.

Capabilities

Full v1 API coverage

The MCP server exposes the same production capabilities as the REST API, grouped into predictable read-only tools.

Area	Tools	Quota
IP intelligence	`ip_lookup`, `ip_lookup_self`, `ip_lookup_batch`	IP quota
Risk and reputation	`risk_score`, `risk_score_self`, `email_risk_score`, `ip_reputation`, `tor_check`	IP quota
Email validation	`email_validate`, `email_validate_advanced`, `email_validate_advanced_batch`, `email_validate_advanced_batch_csv`	IP or advanced-email quota
Network and domain	`asn_lookup`, `dns_mx`, `dns_whois`, `dns_reverse`, `dns_forward`, `domain_age`, `domain_age_batch`	IP quota
Account and usage	`rate_limit_info`, `usage_stats`, `usage_summary`, `usage_recent`, `usage_current_month`	No extra lookup quota

Need every argument? Open the MCP tool reference for tool names, required parameters, and example calls.

FAQ

Frequently asked questions

Common questions about the ip-api.io MCP server.

What transport does the ip-api.io MCP server use?

The hosted server uses MCP Streamable HTTP at https://ip-api.io/mcp. Configure your MCP client with that URL and call tools with your ip-api.io API key in the api_key argument.

How do MCP tools authenticate?

Customer-facing tools require api_key as a tool argument. Keep the key in your MCP client or agent secret store and do not paste it into user-visible prompts.

Do MCP calls consume the same quota as REST calls?

Yes. MCP tools use the same IP and advanced-email quota pools as the REST API. Batch tools consume one quota unit per processed item where the REST API does the same.

Which tools are available?

The MCP server exposes the full v1 API surface, including IP lookup, risk scoring, email validation, ASN, DNS, WHOIS, domain age, quota, and usage tools. See the MCP tool reference.

Pricing

Start using IP-API.io to make your website safer and more user-friendly. Keep out unwanted bots, show visitors content that's relevant to where they are, and spot risky IP addresses quickly. It's perfect for making online shopping more personal and keeping your site secure. Get started today with one of the plans!

Small

€10 /mo

100,000 geo ip requests

10,000 advanced email validation requests

Location data

Email validation

Risk score calculation

Currency data

Time zone data

Threat data

Unlimited support

HTTPS encryption

Create Account to Subscribe

Medium

€20 /mo

300,000 geo ip requests

25,000 advanced email validation requests

Location data

Email validation

Risk score calculation

Currency data

Time zone data

Threat data

Unlimited support

HTTPS encryption

Create Account to Subscribe

Need help connecting an agent?

Send us your MCP client, tool call, and error details. We can help with endpoint setup, quota behavior, and response fields.

Contact Support

Prefer plain HTTP?

The REST API and official SDKs expose the same underlying data if your environment does not support MCP yet.

View SDKs