summarize_ips
Generate statistical summaries and insights from lists of IP addresses, providing analysis reports and map visualizations for network intelligence.
Instructions
Summarize a list of IP addresses with statistics and insights.
Args: ips: List of IP addresses to summarize (up to 500,000)
Returns: Summary report with statistics and map URL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ips | Yes |
Implementation Reference
- src/mcp_ipinfo/server.py:105-121 (handler)The MCP tool handler for 'summarize_ips'. Decorated with @mcp.tool() for automatic registration and schema generation from signature/docstring. Joins IP list into text and delegates to IPInfoClient.summarize_ips.@mcp.tool() async def summarize_ips(ips: list[str], ctx: Context[Any, Any, Any]) -> dict[str, Any]: """Summarize a list of IP addresses with statistics and insights. Args: ips: List of IP addresses to summarize (up to 500,000) Returns: Summary report with statistics and map URL. """ client = get_client(ctx) ips_text = "\n".join(ips) try: return await client.summarize_ips(ips_text) except IPInfoAPIError as e: ctx.error(f"API error: {e.message}") raise
- src/mcp_ipinfo/api_client.py:165-170 (helper)Supporting client method that performs the actual HTTP POST request to the IPInfo.io /tools/summarize-ips endpoint, sending the newline-separated IPs as plain text body.async def summarize_ips(self, ips: str) -> dict[str, Any]: """Summarize a list of IP addresses.""" data = await self._request( "POST", "/tools/summarize-ips", params={"cli": "1"}, data=ips, content_type="text/plain" ) return data
- src/mcp_ipinfo/server.py:105-105 (registration)The @mcp.tool() decorator registers the summarize_ips function as an MCP tool, deriving input schema from args and docstring.@mcp.tool()