SimpleLocalize MCP Server

Instructions

Implementation Reference

• main.py:174-205 (handler)

  The handler function decorated with @mcp.tool() that implements the logic to fetch and format the environment status from the SimpleLocalize API.

  @mcp.tool()
  async def get_environment_status(environment_key: str) -> str:
      """Get the current status of a specified environment.
      
      This endpoint returns information about the environment including the number of keys,
      languages, non-empty translations, creation date, and available resources.
      
      Args:
          environment_key: The environment key to check status for (e.g., "_latest", "_production", or custom key)
      """
      if not environment_key:
          raise ValueError("Environment key is required")
      
      try:
          result = await make_simplelocalize_request(
              "GET",
              f"/api/v2/environments/{environment_key}"
          )
          
          data = result.get("data", {})
          
          # Format the response in a readable way
          status_info = f"""Environment '{environment_key}' Status:
  - Number of keys: {data.get('numberOfKeys', 0)}
  - Number of languages: {data.get('numberOfLanguages', 0)}
  - Non-empty translations: {data.get('numberOfNonEmptyTranslations', 0)}
  - Created at: {data.get('createdAt', 'Unknown')}
  - Number of resources: {len(data.get('resources', []))}"""
          
          return status_info
      except SimpleLocalizeError as e:
          return str(e)