serp_list_languages

Instructions

Shows common language codes that can be used to get results in specific languages.

Returns:
    Table of language codes and their languages.

Implementation Reference

• tools/info_tools.py:67-93 (handler)

  The main handler function for the serp_list_languages tool. It is decorated with @mcp.tool() and returns a formatted markdown table of common language codes for Google Search (e.g., en, zh-cn, es).

  @mcp.tool()
  async def serp_list_languages() -> str:
      """List commonly used language codes for Google search.
  
      Shows common language codes that can be used to get results in specific languages.
  
      Returns:
          Table of language codes and their languages.
      """
      # Last updated: 2026-04-05
      return """Common Language Codes for Google Search:
  
  | Code    | Language              | Code    | Language              |
  |---------|----------------------|---------|----------------------|
  | en      | English              | ja      | Japanese             |
  | zh-cn   | Chinese (Simplified) | ko      | Korean               |
  | zh-tw   | Chinese (Traditional)| hi      | Hindi                |
  | es      | Spanish              | pt      | Portuguese           |
  | fr      | French               | ru      | Russian              |
  | de      | German               | ar      | Arabic               |
  | it      | Italian              | th      | Thai                 |
  | nl      | Dutch                | vi      | Vietnamese           |
  | pl      | Polish               | tr      | Turkish              |
  
  Usage: Pass the language code to the `language` parameter.
  Example: serp_google_search(query="news", language="zh-cn")
  """

• main.py:183-186 (registration)

  Registration entry in the main.py tools list describing the tool for the MCP server manifest (name: serp_list_languages, description: List supported languages).

  {
      "name": "serp_list_languages",
      "description": "List supported languages",
  },

• main.py:126-126 (registration)

  Registration listing in the startup printout of available tools.

  safe_print("    - serp_list_languages")

• tools/info_tools.py:67-68 (schema)

  The @mcp.tool() decorator from FastMCP implicitly handles schema/registration. The function has no parameters, and its return type is str (markdown table).

  @mcp.tool()
  async def serp_list_languages() -> str:

• core/server.py:48-52 (helper)

  The FastMCP server instance (mcp) that powers the @mcp.tool() decorator, defined in core/server.py.

  mcp = FastMCP(
      settings.server_name,
      icons=[Icon(src="
  ", mimeType="image/png")],
      **mcp_kwargs,
  )