MCP Server for IPLocate API - IP geolocation and fraud detection
MCP Server for the IPLocate API, providing IP geolocation and fraud detection capabilities through Claude and other MCP-compatible clients.
This MCP server provides access to the following IPLocate API capabilities:
bash
npm install -g @feedmob/iplocate
`$3
`bash
cd src/iplocate
npm install
npm run build
`Configuration
Set the following environment variables:
`bash
Required
IPLOCATE_API_KEY=your_api_key_hereOptional (defaults to https://iplocate.feedmob.ai)
IPLOCATE_API_BASE=https://iplocate.feedmob.ai
`$3
Add to your
claude_desktop_config.json:`json
{
"mcpServers": {
"iplocate": {
"command": "npx",
"args": ["-y", "@feedmob/iplocate"],
"env": {
"IPLOCATE_API_KEY": "your_api_key_here"
}
}
}
}
`Or if using from source:
`json
{
"mcpServers": {
"iplocate": {
"command": "node",
"args": ["/absolute/path/to/fm-mcp-servers/src/iplocate/dist/index.js"],
"env": {
"IPLOCATE_API_KEY": "your_api_key_here"
}
}
}
}
`Available Tools
$3
Get geographic location information for a single IP address.Parameters:
-
ip (optional): IP address to lookup. If not provided, uses requester's IPExample:
`
lookup_ip with ip="8.8.8.8"
`$3
Get geographic location information for multiple IP addresses at once.Parameters:
-
ips (required): Array of IP addresses to lookup (max 100)Example:
`
batch_lookup with ips=["8.8.8.8", "1.1.1.1", "208.67.222.222"]
`$3
Check the reputation and fraud risk level of a single IP address.Parameters:
-
ip (optional): IP address to check. If not provided, uses requester's IPReturns:
- Fraud score (0-100, higher = more risky)
- Proxy/VPN/Tor detection
- ISP and organization info
- Abuse indicators
- Connection type
- Risk assessment interpretation
Example:
`
fraud_check with ip="8.8.8.8"
`$3
Check reputation and fraud risk for multiple IP addresses at once.Parameters:
-
ips (required): Array of IP addresses to check (max 50)Example:
`
batch_fraud_check with ips=["8.8.8.8", "1.1.1.1", "9.9.9.9"]
`$3
View current IPQualityScore API quota usage.Parameters: None
Returns:
- Total credits
- Remaining credits
- Usage percentage
- Reset date
- Below threshold status
Example:
`
get_usage_stats
`$3
Force refresh the quota cache to get the latest quota information.Parameters: None
Example:
`
refresh_quota
``- GeoIP Lookup: Maximum 100 IPs per batch request, no rate limiting
- Fraud Check: Maximum 50 IPs per batch request, subject to quota limits
- Quota Protection: System automatically blocks new fraud check requests when remaining quota < 20%
- Cache:
- GeoIP lookups: No cache (real-time)
- Fraud checks: 24-hour cache
- Quota status: 5-minute cache
For issues or questions:
- GitHub Issues: https://github.com/feed-mob/fm-mcp-servers/issues
MIT