IPInfo MCP Server

Instructions

Implementation Reference

• src/mcp_ipinfo/server.py:72-84 (handler)

  The main execution logic for the get_account_info tool. It retrieves the IPInfo client and calls get_me() to fetch account information, handling errors appropriately.

  @mcp.tool()
  async def get_account_info(ctx: Context[Any, Any, Any]) -> MeResponse:
      """Get IPInfo account information and API limits.
  
      Returns:
          Account information including API limits and available features.
      """
      client = get_client(ctx)
      try:
          return await client.get_me()
      except IPInfoAPIError as e:
          ctx.error(f"API error: {e.message}")
          raise

• src/mcp_ipinfo/api_models.py:96-100 (schema)

  Pydantic model defining the output schema for the get_account_info tool response, including token, request limits, and features.

  class MeResponse(BaseModel):
      token: str = Field(..., description="API token")
      requests: dict[str, int] = Field(..., description="Request limits and usage")
      features: dict[str, Any] = Field(..., description="Available features")

• src/mcp_ipinfo/server.py:29-38 (helper)

  Shared helper function to lazily initialize and return the IPInfoClient instance used by get_account_info and other tools.

  def get_client(ctx: Context[Any, Any, Any]) -> IPInfoClient:
      """Get or create the API client instance."""
      global _client
      if _client is None:
          api_token = os.environ.get("IPINFO_API_TOKEN")
          if not api_token:
              ctx.warning("IPINFO_API_TOKEN is not set - some features may be limited")
          _client = IPInfoClient(api_token=api_token)
      return _client

• src/mcp_ipinfo/server.py:72-72 (registration)

  The @mcp.tool() decorator registers the get_account_info function as an MCP tool in the FastMCP server instance.

  @mcp.tool()