goodday-mcp

Instructions

Implementation Reference

• goodday_mcp/main.py:633-649 (handler)

  The handler function for the 'get_user' MCP tool. It fetches user details from the Goodday API endpoint 'user/{user_id}' and formats the response using format_user.

  @mcp.tool()
  async def get_user(user_id: str) -> str:
      """Get details of a specific user.
  
      Args:
          user_id: The ID of the user to retrieve
      """
      data = await make_goodday_request(f"user/{user_id}")
      
      if not data:
          return "User not found."
      
      if isinstance(data, dict) and "error" in data:
          return f"Unable to fetch user: {data.get('error', 'Unknown error')}"
      
      return format_user(data)

• goodday_mcp/main.py:135-149 (helper)

  Helper function used by get_user to format the raw user data dictionary into a human-readable string.

  def format_user(user: dict) -> str:
      """Format a user into a readable string with safe checks."""
      if not isinstance(user, dict):
          return f"Invalid user data: {repr(user)}"
  
      # Defensive defaults in case nested keys are not dicts
      role = user.get('role') if isinstance(user.get('role'), dict) else {}
  
      return f"""
  User ID: {user.get('id', 'N/A')}
  Name: {user.get('name', 'N/A')}
  Email: {user.get('email', 'N/A')}
  Role: {role.get('name', 'N/A')}
  Status: {user.get('status', 'N/A')}
  """.strip()

• goodday_mcp/main.py:165-173 (helper)

  Helper function to fetch all users and create a mapping of user IDs to names, potentially useful for resolving user names in tool outputs.

  async def get_user_mapping() -> dict:
      """Get mapping of user IDs to names."""
      data = await make_goodday_request("users")
      user_id_to_name = {}
      if isinstance(data, list):
          for u in data:
              if isinstance(u, dict):
                  user_id_to_name[u.get("id")] = u.get("name", "Unknown")
      return user_id_to_name

• goodday_mcp/main.py:633-633 (registration)

  MCP tool registration decorator for the get_user function.

  @mcp.tool()