IPInfo MCP Server

Instructions

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()