IP Geolocation Skill

Use this skill to query geographic and ASN information from IP addresses through the mcp-geoip-server MCP service.

This skill is designed for:

• - Single IP lookup
• Multi-IP batch lookup
• Domain-to-IP then geolocation workflow
• Structured result output for quick user reading

MCP Server

• - Name: INLINECODE1
• URL: INLINECODE2
• Transport: Streamable HTTP

VS Code MCP Configuration

Add to .vscode/mcp.json (workspace) or user MCP settings:

CODEBLOCK0

Tools

get_ip_geolocation

Look up geolocation information for one IP.

Input:

Output fields:

Detailed tool schema and protocol notes: API reference

Execution Workflow

1. 1. Extract query targets from user input.
2. Classify each target as IPv4, IPv6, or domain.
3. If target is a domain, resolve to IP first using resolve script.
4. Call get_ip_geolocation for each IP.
5. Return concise and structured results.
6. If multiple IPs are provided, present results in a table for easy comparison.

Input Handling Rules

• - Trim whitespace and punctuation around candidate IPs.
• Keep duplicates out during batch lookup.
• Support both IPv4 and IPv6.
• If input is neither valid IP nor resolvable domain, return a clear validation error.
• For script-based calls, only valid IP literals are sent to remote MCP (invalid inputs are rejected locally).
• Private/reserved IP ranges (for example 127.0.0.1, 10.x.x.x, 192.168.x.x, fc00::/7) must not be sent to external MCP.

Security and Privacy

• - This skill sends queried IP addresses to an external MCP service (ip.api4claw.com).
• The default endpoint uses HTTPS transport to encrypt traffic in transit.
• The script implementation is restricted to a fixed HTTPS endpoint (https://ip.api4claw.com/mcp) to reduce misuse risk.
• Private/internal IPs are blocked in the script implementation to reduce privacy leakage risk.

Output Format

Use this format by default:

If a field is empty, display -.

Error Handling

• - MCP unavailable/timeout: explain temporary service issue and suggest retry.
• Invalid IP format: ask user to confirm/correct the IP.
• Private or reserved IP: explain that local/private addresses are intentionally blocked from external lookup.
• Empty/unknown location fields: keep response transparent and do not fabricate values.
• Encoding anomalies (for example garbled country text): include country_code and raw value.
• Session timeout/invalid session ID: re-run MCP initialize to get a new Mcp-Session-Id, then retry the failed tool call once.

Domain-to-IP Flow

When user asks for a domain location (for example example.com):

1. 1. Resolve A/AAAA records with resolve script.
2. Query each resolved IP using get_ip_geolocation.
3. Summarize domain-level findings and list per-IP differences.

Implementation Scripts

• - invoke MCP lookup: includes initialize before calls and auto re-initialize on session expiration.
• resolve domain: resolves domain to unique A/AAAA addresses.

Example: Single IP

User: INLINECODE31

Call:

INLINECODE32

Response (example):

CODEBLOCK1

Example: Batch IPs

User: INLINECODE33

Execution:

1. 1. Call get_ip_geolocation with INLINECODE35
2. Call get_ip_geolocation with INLINECODE37
3. Return merged table with both records

Success Criteria

• - Every valid input IP returns one result row.
• Invalid targets are explicitly marked with reason.
• No inferred or fabricated geographic values.
• Response is readable for both Chinese and English users.